Zad Top HTTP API کے ساتھ ری سیلر ورک فلو بنائیں

Zad Top ری سیلرز، دکانوں، پینلز اور حسبِ ضرورت بوٹس کے لیے ایک آزاد Telegram بوٹ اور HTTP API ہے۔ یہ Free Fire، PUBG Mobile، Yalla Ludo، Jawaker، iTunes اور Razer Gold کے لیے خدمات فراہم کرتا ہے، جن میں کوڈ ریڈیم کرنا، کارڈ چیک کرنا، کھلاڑی کی تلاش، اسٹاک ریڈیم کرنا اور آرڈر کے اسکرین شاٹس شامل ہیں۔

یہ ریپوزٹری بوٹ کے سورس کوڈ کے بجائے ایک عوامی ڈویلپر ہب ہے۔ لائیو API دستاویزات api.zadtop.com/docs پر دستیاب ہیں، جبکہ ایک انٹرایکٹو Swagger انٹرفیس اور OpenAPI دستاویز بھی موجود ہے۔

آپ کیا بنا سکتے ہیں

Zad Top کے ذریعے آپ ایسا ری سیلر ورک فلو بنا سکتے ہیں جو کھلاڑی کی IDs پر ڈیجیٹل کوڈز بھیجے، ریڈیم کرنے سے پہلے معاون کارڈز چیک کرے، گیم میں کھلاڑی کے نام اور علاقے حاصل کرے، اور محفوظ اسٹاک سے مصنوعات ریڈیم کرے۔ کامیاب ریڈیم کے بعد آپ دکان کے آرڈر کی تصویر بھی حاصل کر سکتے ہیں۔

• Free Fire، PUBG Mobile UC، Yalla Ludo Diamonds اور Gold، اور Jawaker ٹوکنز ریڈیم کریں۔
• معاون Free Fire، PUBG، Yalla Ludo Diamonds، iTunes اور Razer Gold کارڈز چیک کریں۔
• Razer Gold PIN اپنے والیٹ میں ری چارج کریں۔
• کوڈ خرچ کرنے سے پہلے کھلاڑی کا گیم میں نام اور علاقہ معلوم کریں۔
• بوٹ میں کوڈز محفوظ کریں اور انفرادی کوڈز جمع کرانے کے بجائے اسٹاک پیکس ریڈیم کریں۔
• دکان کے ورک فلو کے لیے آرڈر کا اسکرین شاٹ حاصل کریں۔

HTTP API استعمال کرنے کے لیے Telegram میں @ZadTopBot کھولیں اور Subscription کے بعد HTTP API منتخب کریں۔ آپ کو ایک فعال پلان اور HTTP API ایڈ آن درکار ہے۔ README میں ایڈ آن کی قیمت 30 دن کے لیے 15 USDT درج ہے۔ ایک الگ Code checking subscription خود چیک روٹس کو کال کر سکتی ہے۔

API key حاصل کرنے کے بعد، ہر تصدیق شدہ درخواست میں اسے X-API-Key ہیڈر کے ذریعے بھیجیں:

X-API-Key: pk_YOUR_KEY

نئی key بنانے سے پچھلی key منسوخ ہو جاتی ہے، اس لیے credentials تبدیل کرتے وقت اپنی ایپلیکیشن کی configuration بھی اپ ڈیٹ کریں۔ key کو اپنے سرور پر رکھیں اور اسے براؤزر کے کوڈ یا عوامی ریپوزٹریز میں ظاہر نہ کریں۔

اپنا پہلا فوری ریڈیم کریں

POST /v1/jobs/instant-redeem روٹ ایک player ID کے لیے ایک یا زیادہ کوڈز ریڈیم کرتا ہے۔ درخواست JSON استعمال کرتی ہے اور API key اور content type ہیڈرز کی ضرورت ہوتی ہے۔

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

اس مثال میں game کی قدر freefire ہے۔ دیگر معاون اقدار میں pubg، ludo، ludogold، jawaker، razer_recharge اور API دستاویزات میں بیان کردہ دیگر سروس مخصوص اقدار شامل ہیں۔

ریڈیم کی درخواستیں jobs ہوتی ہیں۔ کسی job کا done تک پہنچنا اس بات کی علامت ہے کہ پراسیسنگ مکمل ہو گئی ہے، لیکن جمع کرائے گئے ہر کوڈ کا اپنا success نتیجہ اور، جہاں قابل اطلاق ہو، err_code ہوتا ہے۔ مکمل شدہ job کو ہر کوڈ کی کامیابی کا ثبوت نہ سمجھیں۔

Jobs اور نتائج کا جائزہ لیں

job کی حالت اور نتیجہ حاصل کرنے کے لیے GET /v1/jobs/{id} استعمال کریں۔ فوری طور پر polling کرنے کے بجائے مقررہ مدت تک انتظار کرنے کے لیے ?wait=25 شامل کیا جا سکتا ہے۔

curl -sS "https://api.zadtop.com/v1/jobs/JOB_ID?wait=25" \
  -H "X-API-Key: pk_YOUR_KEY"

ایک عملی انضمام میں job ID محفوظ کریں، job کا نتیجہ طلب کریں، پھر ہر کوڈ کے نتیجے کا الگ جائزہ لیں۔ کامیاب اور ناکام کوڈز کی اطلاع صارف یا ری سیلر ڈیش بورڈ میں الگ الگ دیں۔

ریڈیم سے پہلے کوڈز چیک کریں

POST /v1/codes/check روٹ 20 تک کارڈز کو ریڈیم کیے بغیر چیک کرتا ہے۔ بڑے بیچز کے لیے POST /v1/jobs/code-check استعمال کریں، جو job کے طور پر 10,000 تک کارڈز کو سپورٹ کرتا ہے۔

معاون نتائج گیم پر منحصر ہوتے ہیں۔ Free Fire غیر استعمال شدہ، استعمال شدہ یا غیر معتبر حالتیں بتا سکتا ہے اور اس میں پیک شامل ہو سکتا ہے۔ PUBG غیر استعمال شدہ، استعمال شدہ، میعاد ختم شدہ یا غیر معتبر حالتیں بتا سکتا ہے اور دکان کو معلوم ہونے کی صورت میں قدر بھی شامل ہو سکتی ہے۔ Yalla Ludo Diamonds کو چیک کیا جا سکتا ہے، لیکن Gold کے لیے چیک روٹ موجود نہیں۔ Diamonds checker کو بھیجا گیا Gold code خرچ کیا جا سکتا ہے، اس لیے جمع کرانے سے پہلے پروڈکٹ کی قسم کی تصدیق کریں۔

iTunes کے چیکس ڈالر بیلنس واپس کرتے ہیں۔ طویل خاموشی کے بعد پہلی ریڈنگ میں ایک منٹ تک لگ سکتا ہے۔ Razer Gold کے چیکس PIN خرچ کیے بغیر live، used یا invalid حالتیں واپس کرتے ہیں، لیکن README کے مطابق فی PIN پانچ درخواستوں کی حد ہے۔

پہلے کھلاڑی کی معلومات حاصل کریں

ریڈیم کرنے سے پہلے GET /v1/player/lookup کال کرکے گیم میں نام اور علاقہ حاصل کریں۔ اس سے درست کوڈ غلط player ID پر بھیجنے سے بچنے میں مدد ملتی ہے۔

curl -sS "https://api.zadtop.com/v1/player/lookup?player_id=2186053213&game=freefire" \
  -H "X-API-Key: pk_YOUR_KEY"

اپنے صارف انٹرفیس میں واپس کی گئی شناختی تفصیلات کو تصدیقی مرحلے کے طور پر استعمال کریں۔ README میں بتایا گیا ہے کہ منتخب کردہ پلیئر ID کی ذمہ داری آپ پر ہے، اور ایک درست کوڈ اس اکاؤنٹ میں کریڈٹ کیا جاتا ہے جو دکان سے پہلے کامیاب رابطے میں بھیجا گیا ہو۔

اسٹاک ریڈیمپشن استعمال کریں

اگر آپ Zad Top میں انوینٹری برقرار رکھتے ہیں تو ہر آرڈر میں کوڈز پیسٹ کرنے کے بجائے محفوظ اسٹاک سے ریڈیم کرنے کے لیے POST /v1/jobs/stock-redeem استعمال کریں۔ GET /v1/stock/summary روٹ گیم اور پیک کے لحاظ سے اسٹاک کی رپورٹ دیتا ہے۔

curl -sS https://api.zadtop.com/v1/stock/summary \
  -H "X-API-Key: pk_YOUR_KEY"

اسٹاک ریڈیمپشن کی درست فیلڈز اور پیک شناخت کنندگان لائیو ریفرنس یا ریپوزٹری کی endpoint گائیڈ سے لیے جانے چاہییں۔ اس سے دستیاب اسٹاک کیٹیگریز کے بارے میں مفروضوں کو ہارڈ کوڈ کرنے سے بچا جا سکتا ہے۔

گیم کے لحاظ سے اہم نکات

• Free Fire: ریڈیمپشن اور چیکنگ کو سپورٹ کرتا ہے۔
• PUBG Mobile: UC ریڈیمپشن اور چیکنگ کو سپورٹ کرتا ہے۔
• Yalla Ludo: ضرورت کے مطابق ludo یا ludogold استعمال کریں۔ ریڈیمپشن کے لیے tier درکار ہے۔ Diamonds چیک کیے جا سکتے ہیں، جبکہ Gold نہیں کیا جا سکتا۔
• Jawaker: ریڈیمپشن کو سپورٹ کرتا ہے، لیکن اس کے 12 حروف والے PIN کے لیے کوئی الگ چیک موجود نہیں۔
• iTunes: درج کردہ سروس کے ذریعے صرف بیلنس چیکنگ کو سپورٹ کرتا ہے؛ غیر فعالیت کے بعد پہلی درخواست میں ایک منٹ تک لگ سکتا ہے۔
• Razer Gold: PIN خرچ کیے بغیر PIN چیکنگ کو سپورٹ کرتا ہے۔ razer_recharge آپریشن PIN کو آپ کے والٹ میں کریڈٹ کرتا ہے اور ای میل ایڈریس اور پاس ورڈ درکار ہوتے ہیں۔ پاس ورڈ محفوظ نہیں کیا جاتا۔

اکاؤنٹ اور دکان کے آپریشنز شامل کریں

API اکاؤنٹ اور ری سیلر سے متعلق روٹس بھی فراہم کرتی ہے:

• اکاؤنٹ کی معلومات کے لیے GET /v1/me۔
• الاؤنس کی معلومات کے لیے GET /v1/quota۔
• آپریشن کی تاریخ کے لیے GET /v1/history۔
• محفوظ شدہ پلیئرز کے لیے GET /v1/players۔
• کامیاب ریڈیمپشن کے بعد دکان کے آرڈر کی تصویر کے لیے POST /v1/order/screenshot۔

یہ روٹس انتظامی ڈیش بورڈ کو سپورٹ کر سکتے ہیں، جبکہ job اور lookup روٹس صارفین کے لیے آرڈر کے عمل کو چلا سکتے ہیں۔

حدود اور استعمال کے اخراجات سمجھیں

README کے مطابق ایک ریڈیم پر فی کوڈ ایک درخواست، ایک چیک پر فی کارڈ ایک درخواست، اور Razer Gold چیک پر فی PIN پانچ درخواستیں خرچ ہوتی ہیں۔ پلیئر lookup پر 0.25 درخواست خرچ ہوتی ہے۔ دکان کی جانب سے انکار اور نتیجہ واپس آنے سے پہلے کی ناکامی بھی دستاویزی استعمال کے قواعد کے مطابق شمار ہوتی ہے۔

روزانہ کی حدود UTC کے مطابق نصف شب کو ری سیٹ ہوتی ہیں اور پلان میں شامل گیمز، Telegram bot اور API کے درمیان مشترک ہوتی ہیں۔ نئے اکاؤنٹس کو 10 مفت ریڈیمز ملتے ہیں۔ پلان کی قیمتیں اور دستیابی تبدیل ہو سکتی ہیں، اس لیے billing workflow بنانے سے پہلے bot یا سرکاری سائٹ کے ذریعے موجودہ شرائط کی تصدیق کریں۔

تجویز کردہ انٹیگریشن کا بہاؤ

1. پلیئر کی گیم، پلیئر ID، پروڈکٹ اور کوڈ حاصل کریں۔
2. پلیئر lookup endpoint کو کال کریں اور تصدیق کے لیے واپس کیا گیا نام اور خطہ دکھائیں۔
3. سپورٹ شدہ پروڈکٹس کے لیے ریڈیمپشن سے پہلے کوڈ چیک کریں۔
4. فوری ریڈیمپشن یا اسٹاک ریڈیمپشن job جمع کریں۔
5. /v1/jobs/{id} کو بار بار چیک کریں یا wait پیرامیٹر استعمال کریں۔
6. مجموعی job state اور ہر کوڈ کی success اور err_code فیلڈز کا جائزہ لیں۔
7. صارف کو واضح نتیجہ دکھائیں اور اختیاری طور پر آرڈر کا اسکرین شاٹ طلب کریں۔

اعلیٰ درجے کے نفاذی نکات

اسناد محفوظ رکھیں

API key کو سرور سائیڈ environment variables یا secrets manager میں محفوظ کریں۔ اسے موبائل ایپلی کیشنز، فرنٹ اینڈ JavaScript، logs یا سپورٹ اسکرین شاٹس میں رکھنے سے گریز کریں۔

غیر ہم وقتی پروسیسنگ کے لیے ڈیزائن کریں

ریڈیم اور batch-check آپریشنز jobs ہوتے ہیں۔ job identifiers محفوظ کریں، محفوظ status reads کے لیے retries کو سپورٹ کریں، اور transport errors کو code-level failures سے الگ رکھیں۔ done job کے بعد بھی انفرادی نتائج کا جائزہ لینا ضروری ہے۔

پروڈکٹ اور گیم کے امتزاج کی توثیق کریں

اپنی ایپلی کیشن میں واضح product mapping استعمال کریں تاکہ Diamonds، Gold، UC اور دیگر پروڈکٹس غلطی سے غلط route یا checker کو نہ بھیجے جائیں۔ یہ Yalla Ludo کے لیے خاص طور پر اہم ہے، جہاں Gold کا کوئی چیک نہیں ہوتا اور ناموزوں check request اسے خرچ کر سکتی ہے۔

تاخیر اور کوٹے کا حساب رکھیں

iTunes بیلنس read اور batch jobs کے لیے اضافی وقت دیں۔ quota usage کو مقامی طور پر track کریں، خاص طور پر Razer checks کے لیے، کیونکہ ایک PIN پانچ requests استعمال کر سکتا ہے۔ bot اور API کی سرگرمی کے درمیان مشترک روزانہ الاؤنس کو بھی مدنظر رکھیں۔

نتیجہ

Zad Top ڈیجیٹل گیم اور گفٹ کارڈ ری سیلر workflows کے لیے ایک مرکوز API فراہم کرتا ہے۔ API access اور X-API-Key header سے آغاز کریں، پلیئر کی شناخت کی تصدیق کریں، جہاں سپورٹ ہو وہاں checks استعمال کریں، redemption jobs جمع کریں، اور ہر code-level result کا جائزہ لیں۔ endpoint کی تفصیلات اور موجودہ سروس کے رویے کے لیے HTML API reference، Swagger documentation اور منصوبے کی GitHub repository دیکھیں۔

Zad Top ایک آزاد سروس ہے اور Garena، Krafton، Tencent، Yalla Games، Apple، Razer یا Jawaker سے وابستہ نہیں ہے۔