Zad Top HTTP API

अपनी दुकान, साइट या बॉट उसी इंजन से जोड़ें जो @ZadTopBot चलाता है। प्रमाण के लिए एक कुंजी, अतुल्यकालिक रिडीम और जाँच, और हर कोड का विस्तृत नतीजा।

पूरा संदर्भ Swagger में आज़माएँ

आधार URL

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`	प्लेयर आईडी के लिए Free Fire, PUBG, Yalla Ludo या Jawaker कोड रिडीम करें।
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 देता है।