Zad Topرابط HTTP API زاد تاپ
فروشگاه، سایت یا ربات‌تان را به همان موتوری وصل کنید که @ZadTopBot را می‌گرداند. یک کلید برای احراز، کارهای ناهمگام شارژ و بررسی، و نتیجهٔ جدا برای هر کد.
نشانی پایه
https://api.zadtop.com
گرفتن کلید
- @ZadTopBot ← اشتراک ← HTTP API.
- یک طرح فعال به‌همراه افزونهٔ API داشته باشید — ۱۵ USDT ثابت برای هر ۳۰ روز، هر طرحی که باشد.
- روی کلید جدید بزنید. ساختن کلید، کلید قبلی را فوراً باطل می‌کند.
احراز هویت
کلید را در هر درخواست در سرآیند 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 | تا ۲۰ کارت را بدون شارژ بخوانید. |
| POST | /v1/jobs/code-check | همان بررسی تا ۲۰۰ کارت، به‌صورت یک کار. |
| 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 صفر می‌شود و بازی‌های آن طرح در آن شریک‌اند. شارژ هر کد ۱ درخواست، بررسی هر کارت ۱ و جستجوی بازیکن ۰٫۲۵ است. رد فروشگاه حساب می‌شود؛ خطای سمت ما خودکار به سقف‌تان برمی‌گردد. ربات و API یک سقف مشترک دارند.
خطاها
اعتبارسنجی 400 با رمزی داخل detail.error می‌دهد؛ احراز 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 | مشکل موقت پیش از روشن شدن نتیجه. بازگردانده شد؛ همان کد را دوباره امتحان کنید. |
مناطق
بازیکنان تقریباً همهٔ کشورها پشتیبانی می‌شوند. جایی که گارنا اصلاً کوپن نمی‌فروشد — آمریکا، آرژانتین، شیلی و روسیه — جستجوی بازیکن پیش از به خطر افتادن هر کد 422 UNSUPPORTED_REGION می‌دهد.