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

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

التوثيق الكامل تجربة في Swagger

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

https://api.zadtop.com

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

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

المصادقة

أرسل المفتاح في ترويسة 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`	الفحص نفسه حتى 200 كود كمهمة غير متزامنة.
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.

الألعاب

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

`freefire`	كود 16 رقماً · آيدي 6–12 · فحص + شحن + بحث
`pubg`	كود 18 حرفاً · آيدي 8–11 يبدأ بـ 5 · فحص + شحن + بحث
`ludo` / `ludogold`	كود 12 حرفاً · آيدي 6–16 · شحن مع `tier` (لا فحص مستقل)
`jawaker`	قسيمة 10 أحرف أو رمز Mintroute من 12 · آيدي 6–12 · شحن + بحث (لا فحص مستقل)

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

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

الأخطاء

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

المناطق

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