API key और सुरक्षा

अपनी key कैसे भेजें, एक से ज़्यादा key कैसे इस्तेमाल करें और सिर्फ अपने सर्वर को कैसे अनुमति दें।

आपकी key

हर रिक्वेस्ट में आपके अकाउंट पेज की API key होती है: JSON रिक्वेस्ट में clientKey, in.php और res.php में key। key 32 कैरेक्टर की होती है (0-9, a-f)। इसे अपने सर्वर पर रखें; जिसके पास key है, वह आपका बैलेंस खर्च कर सकता है।

POST /getBalance

{
  "clientKey": "YOUR_API_KEY"
}

https://unlock-api.com/res.php?key=YOUR_API_KEY&action=getbalance&json=1

और key

अकाउंट पेज पर आप 5 तक अतिरिक्त key बना सकते हैं, जैसे हर सर्वर या प्रोजेक्ट के लिए एक। ये एक ही बैलेंस शेयर करती हैं, दिखाती हैं कि आखिरी बार कब इस्तेमाल हुईं और इन्हें एक-एक करके बंद किया जा सकता है।

IP अनुमति सूची

अकाउंट पेज पर 20 तक IP एड्रेस जोड़ें, फिर सिर्फ वही एड्रेस आपकी key इस्तेमाल कर सकते हैं। दूसरे एड्रेस से आई रिक्वेस्ट को ERROR_IP_NOT_ALLOWED मिलता है और कोई चार्ज नहीं लगता।

एरर

{
  "errorId": 1,
  "errorCode": "ERROR_IP_NOT_ALLOWED",
  "errorDescription": "Requests from this IP are not allowed. Add it to the IP allow list on your account page."
}

ब्राउज़र से कॉल

header_acao=1 भेजने पर in.php और res.php CORS हेडर Access-Control-Allow-Origin: * जोड़ते हैं। पब्लिक वेब पेज से API कॉल करने पर आपकी key दिख जाती है, इसलिए इसे सिर्फ अपने टूल के लिए इस्तेमाल करें।