UNLOCK API
مفتاح API
مفاتيح API والأمان
MarkdownOpenAPI

مفاتيح API والأمان

كيف ترسل مفتاحك، وتستخدم أكثر من مفتاح، وتسمح لخوادمك فقط.

مفتاحك

كل طلب يحمل مفتاح API من صفحة حسابك: clientKey في طلبات JSON، وkey في in.php وres.php. المفتاح 32 حرفًا (0-9، a-f). احفظه على خادمك؛ أي شخص يملك المفتاح يمكنه إنفاق رصيدك.
POST /getBalance
{
  "clientKey": "YOUR_API_KEY"
}

مفاتيح إضافية

يمكنك إنشاء حتى 5 مفاتيح إضافية في صفحة الحساب، مثلًا مفتاح لكل خادم أو مشروع. تتشارك الرصيد نفسه، وتعرض آخر وقت استُخدمت فيه، ويمكن إيقاف كل منها على حدة.

قائمة IP المسموحة

أضف حتى 20 عنوان IP في صفحة الحساب، ولن تستطيع استخدام مفاتيحك إلا هذه العناوين. الطلبات من عناوين أخرى تحصل على 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."
}

الطلبات من المتصفح

يضيف in.php وres.php ترويسة CORS Access-Control-Allow-Origin: * عند إرسال header_acao=1. استدعاء الـ API من صفحة ويب عامة يكشف مفتاحك، لذا استخدم ذلك لأدواتك الخاصة فقط.