زاد ٹاپ HTTP API

اپنی دکان، سائٹ یا بوٹ اسی انجن سے جوڑیں جو @ZadTopBot چلاتا ہے۔ تصدیق کے لیے ایک کلید، غیر ہم وقت ریڈیم اور چیک، اور ہر کوڈ کا تفصیلی نتیجہ۔

مکمل حوالہ Swagger میں آزمائیں

بنیادی پتہ

https://api.zadtop.com

کلید لیں

@ZadTopBot → سبسکرپشن → HTTP API۔
فعال پلان کے ساتھ API ایڈ آن رکھیں — 30 دن کے مقررہ 15 USDT، پلان کوئی بھی ہو۔
نئی API کلید دبائیں۔ نئی کلید پچھلی کو فوراً ختم کر دیتی ہے۔

تصدیق

ہر درخواست میں کلید ہیڈر X-API-Key میں بھیجیں۔ پلان یا API ایڈ آن ختم ہو تو رسائی رکتی ہے، اور تجدید پر وہی کلید چل پڑتی ہے۔

X-API-Key: pk_YOUR_KEY_HERE

کام کیسے چلتے ہیں

ریڈیم اور بڑے چیک غیر ہم وقت ہیں۔ POST درخواست جانچ کر فوراً 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`	ریڈیم · کوڈ چیک · پلیئر تلاش
`pubg`	ریڈیم · کوڈ چیک · پلیئر تلاش
`ludo` / `ludogold`	`tier` کے ساتھ ریڈیم · پلیئر تلاش · کوڈ چیک نہیں
`jawaker`	ریڈیم · پلیئر تلاش · کوڈ چیک نہیں

روزانہ حد

ہر پلان کی ایک روزانہ حد ہوتی ہے جو آدھی رات UTC پر ری سیٹ ہوتی ہے اور پلان کی گیمز میں مشترک ہوتی ہے۔ ریڈیم فی کوڈ 1 درخواست، کوڈ چیک فی کارڈ 1، اور پلیئر تلاش 0.25۔ دکان کا انکار شمار ہوتا ہے؛ ہماری طرف کی ناکامی خود حد میں واپس آ جاتی ہے۔ بوٹ اور API ایک ہی حد استعمال کرتے ہیں۔

غلطیاں

تصدیق detail.error کے اندر کوڈ کے ساتھ 400 دیتی ہے؛ شناخت 401 یا 403؛ بہت زیادہ کال 429۔ محفوظ دوبارہ شروع پر نئے کام 503 SERVICE_DRAINING دیتے ہیں — تھوڑی دیر بعد دوبارہ کوشش کریں۔ مکمل فہرست مکمل حوالے میں ہے۔

درخواست کی غلطیاں

401		API کلید موجود نہیں، غلط ہے یا نئی کلید سے بدل گئی۔ بوٹ سے دوبارہ کاپی کریں۔
403		API ایڈ آن کے ساتھ کوئی فعال پلان نہیں۔ بوٹ میں تجدید کریں۔
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`	دکان کارڈ نہیں پہچانتی۔ دیکھیں کہ درست لکھا گیا۔
`REGION_MISMATCH`	کارڈ پلیئر کے علاقے کے بجائے کسی اور علاقے کا ہے۔
`PLAYER_NOT_FOUND`	اس آئی ڈی کا کوئی اکاؤنٹ نہیں۔ کارڈ استعمال نہیں ہوئے۔
`NETWORK`	نتیجہ معلوم ہونے سے پہلے عارضی مسئلہ۔ واپس کر دیا گیا؛ وہی کوڈ دوبارہ آزمائیں۔

علاقے

تقریباً ہر ملک کے کھلاڑی سپورٹ ہیں۔ جہاں Garena سرے سے واؤچر نہیں بیچتی — امریکہ، ارجنٹائن، چلی اور روس — پلیئر تلاش کسی کوڈ کے خطرے سے پہلے 422 UNSUPPORTED_REGION دیتی ہے۔