واجهة زاد توب HTTP API
اربط متجرك أو موقعك أو بوتك بمحرك الشحن نفسه الذي يعمل به @ZadTopBot. مصادقة بمفتاح واحد، ومهام شحن وفحص غير متزامنة، ونتيجة مفصّلة لكل كود.
العنوان الأساسي
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 | الفحص نفسه حتى 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. جدّد من البوت. | |
| 403 | CHECK_CODE_SUBSCRIPTION_ONLY | مفتاحك عليه اشتراك فحص الأكواد فقط: يفحص الأكواد ولا يشحنها. |
| 403 | GAME_NOT_IN_PLAN | باقتك لا تشمل هذه اللعبة. أضف اللعبة إلى باقتك من البوت. |
| 400 | INVALID_CODE | الكود غير صالح لهذه اللعبة. لم يُرسل أو يُحسب شيء. |
| 400 | INVALID_PLAYER_ID | آيدي اللاعب غير صالح لهذه اللعبة. لم يُرسل أو يُحسب شيء. |
| 400 | INSUFFICIENT_BALANCE | رصيدك لا يكفي للسعر. اشحن رصيدك من البوت. |
| 429 | QUOTA_EXHAUSTED | لم يتبقَّ ما يكفي من الطلبات اليوم. تتجدد عند منتصف الليل UTC أو عند شراء باقة. |
| 429 | RATE_LIMIT | طلبات كثيرة جداً. انتظر مدة Retry-After ثم أعد المحاولة. |
| 503 | SERVICE_DRAINING | صيانة قصيرة. لم يُضف شيء للطابور؛ أعد المحاولة بعد ثوانٍ. |
نتيجة كل كود (err_code)
CODE_ALREADY_USED | الكود مستخدم من قبل. لا تُعِد المحاولة به. |
|---|---|
INVALID_CODE | المتجر لا يتعرّف على الكود. تأكد من كتابته. |
CODE_VOIDED | الكود غير صالح. تم إلغاء الكود من مصدر البطاقة. المحاولة تُخصم. |
REGION_MISMATCH | الكود لمنطقة غير منطقة اللاعب. |
PLAYER_NOT_FOUND | لا يوجد حساب بهذا الآيدي. لم تُستخدم الأكواد. |
NETWORK | مشكلة مؤقتة قبل معرفة النتيجة. أُعيد الطلب لحدّك؛ أعد المحاولة بالكود نفسه. |
المناطق
لاعبو معظم الدول مدعومون. وحيث لا تبيع غارينا قسائم أصلاً — الولايات المتحدة والأرجنتين وتشيلي وروسيا — يعيد بحث اللاعب 422 UNSUPPORTED_REGION قبل أن يتعرّض أي كود للخطر.