واجهة زاد توب HTTP API

اربط متجرك أو موقعك أو بوتك بمحرك الشحن نفسه الذي يعمل به @ZadTopBot. مصادقة بمفتاح واحد، ومهام شحن وفحص غير متزامنة، ونتيجة مفصّلة لكل كود.

العنوان الأساسي

https://api.zadtop.com

الحصول على مفتاح

  1. افتح @ZadTopBot ← الاشتراك ← HTTP API.
  2. اشترِ باقة نشطة مع إضافة الـ API بسعر ثابت 15 USDT لكل 30 يوماً، أيّاً كانت الباقة.
  3. اضغط «مفتاح جديد». إنشاء مفتاح جديد يُلغي المفتاح السابق فوراً.

المصادقة

أرسل المفتاح في ترويسة X-API-Key مع كل طلب. تتوقف الواجهة عن العمل إن انتهت باقتك أو إضافة الـ API، وتعود مباشرةً عند التجديد بالمفتاح نفسه.

X-API-Key: pk_YOUR_KEY_HERE

كيف تعمل المهام

عمليات الشحن والفحص الجماعي غير متزامنة: يتحقق الطلب من بياناتك ويعيد job_id فوراً، ثم تقرأ النتيجة عبر GET /v1/jobs/{id} — أو تضيف ?wait=25 ليعود الطلب بمجرد انتهاء المهمة بدل الاستعلام المتكرر.

وصول المهمة إلى done لا يعني نجاح كل كود. تعني أن العمل نُفِّذ؛ أما نتيجة كل كود فتُقرأ من results[].success ومن err_code عند الفشل.

curl -sS -X POST https://api.zadtop.com/v1/jobs/instant-redeem \
  -H "X-API-Key: pk_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"2186053213","codes":["4233939008625064"],"game":"freefire"}'

فحص الأكواد دون شحنها

يعيد لكل كود حالته: valid أو used أو invalid وغيرها، ومع with_value يعيد أيضاً قيمة الفئة. لا يُشحن شيء والكود السليم يبقى سليماً.

curl -sS -X POST https://api.zadtop.com/v1/codes/check \
  -H "X-API-Key: pk_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"codes":["7397062240255931","5539151276341494"],"with_value":true}'

أهم المسارات

POST/v1/jobs/instant-redeemشحن أكواد فري فاير أو ببجي أو يلا لودو أو جواكر على آيدي لاعب.
POST/v1/jobs/stock-redeemالشحن من مخزونك المحفوظ باختيار الفئات.
POST/v1/codes/checkفحص حتى 20 كوداً دون شحن أي منها.
POST/v1/jobs/code-checkالفحص نفسه حتى 10,000 كود كمهمة غير متزامنة.
GET/v1/player/lookupاسم اللاعب داخل اللعبة ومنطقته.
GET/v1/jobs/{id}حالة مهمة واحدة ونتيجتها.
GET/v1/stock/summaryما تملكه من مخزون لكل لعبة وفئة.
POST/v1/order/screenshotصورة تأكيد الطلب من المتجر بصيغة PNG.
GET/v1/me · /v1/quota · /v1/history · /v1/playersالحساب والحدّ المتبقي والطلبات السابقة واللاعبون المحفوظون.
POST/v1/subscription/purchase · purchase-api-addonشراء أو تمديد باقة من رصيد USDT.
POST/v1/subscription/purchase-check-codeشراء اشتراك فحص الأكواد من رصيد USDT.

الألعاب

نفس المسارات لكل الألعاب — غيّر game فقط. الفئات والأمثلة في التوثيق وفي صفحات الألعاب.

freefireشحن · فحص أكواد · بحث عن اللاعب
pubgشحن · فحص أكواد · بحث عن اللاعب
ludo / ludogoldشحن مع tier · بحث عن اللاعب · فحص أكواد الماس
jawakerشحن · بحث عن اللاعب · لا يوجد فحص
itunesفحص الرصيد · القيمة في value_label · بلا لاعب وبلا شحن
razerفحص الأكواد · صالح/مستخدم/خاطئ · بلا قيمة · 5 طلبات لكل كود
razer_rechargeيشحن الكود إلى محفظتك · تم الشحن / مستخدم / خاطئ · 5 طلبات لكل كود

الحصة اليومية

لكل باقة حدٌّ يومي يُصفّر عند منتصف الليل بتوقيت UTC، وتتشاركه الألعاب التي تغطيها الباقة. الشحن طلب واحد لكل كود، وفحص الكود طلب واحد لكل كود، وكشف اسم اللاعب 0.25. رفض المتجر يُحسب، أما ما يفشل من جهتنا فيُعاد إلى حدّك تلقائياً. البوت والـ API يتشاركان الحدّ نفسه.

الأخطاء

أخطاء التحقق تعيد 400 مع رمز داخل detail.error، والمصادقة 401 أو 403، وتجاوز المعدّل 429. وأثناء إعادة التشغيل الآمنة تعيد المهام الجديدة 503 SERVICE_DRAINING فأعد المحاولة بعد قليل. القائمة الكاملة في التوثيق الكامل.

أخطاء الطلب

401مفتاح الـ API مفقود أو خاطئ أو استُبدل بمفتاح أحدث. انسخه من جديد من البوت.
403لا توجد باقة نشطة مع إضافة الـ API. جدّد من البوت.
403CHECK_CODE_SUBSCRIPTION_ONLYمفتاحك عليه اشتراك فحص الأكواد فقط: يفحص الأكواد ولا يشحنها.
403GAME_NOT_IN_PLANباقتك لا تشمل هذه اللعبة. أضف اللعبة إلى باقتك من البوت.
400INVALID_CODEالكود غير صالح لهذه اللعبة. لم يُرسل أو يُحسب شيء.
400INVALID_PLAYER_IDآيدي اللاعب غير صالح لهذه اللعبة. لم يُرسل أو يُحسب شيء.
400INSUFFICIENT_BALANCEرصيدك لا يكفي للسعر. اشحن رصيدك من البوت.
429QUOTA_EXHAUSTEDلم يتبقَّ ما يكفي من الطلبات اليوم. تتجدد عند منتصف الليل UTC أو عند شراء باقة.
429RATE_LIMITطلبات كثيرة جداً. انتظر مدة Retry-After ثم أعد المحاولة.
503SERVICE_DRAININGصيانة قصيرة. لم يُضف شيء للطابور؛ أعد المحاولة بعد ثوانٍ.

نتيجة كل كود (err_code)

CODE_ALREADY_USEDالكود مستخدم من قبل. لا تُعِد المحاولة به.
INVALID_CODEالمتجر لا يتعرّف على الكود. تأكد من كتابته.
CODE_VOIDEDالكود غير صالح. تم إلغاء الكود من مصدر البطاقة. المحاولة تُخصم.
REGION_MISMATCHالكود لمنطقة غير منطقة اللاعب.
PLAYER_NOT_FOUNDلا يوجد حساب بهذا الآيدي. لم تُستخدم الأكواد.
NETWORKمشكلة مؤقتة قبل معرفة النتيجة. أُعيد الطلب لحدّك؛ أعد المحاولة بالكود نفسه.

المناطق

لاعبو معظم الدول مدعومون. وحيث لا تبيع غارينا قسائم أصلاً — الولايات المتحدة والأرجنتين وتشيلي وروسيا — يعيد بحث اللاعب 422 UNSUPPORTED_REGION قبل أن يتعرّض أي كود للخطر.