Zad Top HTTP API

Mağazanızı, sitenizi veya botunuzu @ZadTopBot'u çalıştıran aynı motora bağlayın. Kimlik için bir anahtar, eşzamansız yükleme ve kontrol işleri, her kod için ayrıntılı sonuç.

Tam başvuru Swagger'da dene

Temel adres

https://api.zadtop.com

Anahtar alın

@ZadTopBot → Abonelik → HTTP API.
Aktif bir planla birlikte API eklentisini tutun — plan ne olursa olsun 30 gün için sabit 15 USDT.
Yeni API anahtarına dokunun. Yeni anahtar öncekini hemen iptal eder.

Kimlik doğrulama

Anahtarı her istekte X-API-Key başlığında gönderin. Planınız veya API eklentisi bitince erişim durur ve yenilemede aynı anahtarla devam eder.

X-API-Key: pk_YOUR_KEY_HERE

İşler nasıl çalışır

Yüklemeler ve toplu kontroller eşzamansızdır. POST isteğinizi doğrular ve hemen bir job_id döner; sonucu GET /v1/jobs/{id} ile okursunuz — veya iş bitince dönsün diye ?wait=25 eklersiniz.

Bir işin done olması her kartın başarılı olduğu anlamına gelmez. İşin yapıldığı anlamına gelir. Her kartın sonucu results[].success içindedir, başarısızlıkta 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"}'

Yüklemeden kod kontrolü

Her kart bir durumla döner — valid, used, invalid ve birkaçı daha — ve with_value ile paket değeri. Hiçbir şey yüklenmez, sağlam kart sağlam kalır.

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}'

Ana yollar

POST	`/v1/jobs/instant-redeem`	Bir oyuncu ID'si için Free Fire, PUBG, Yalla Ludo veya Jawaker kodlarını yükleyin.
POST	`/v1/jobs/stock-redeem`	Paket seçerek kayıtlı stoktan yükleyin.
POST	`/v1/codes/check`	20 karta kadar yüklemeden okuyun.
POST	`/v1/jobs/code-check`	Aynı kontrol, 200 karta kadar, bir iş olarak.
GET	`/v1/player/lookup`	Bir oyuncu ID'sinin oyun içi adı ve bölgesi.
GET	`/v1/jobs/{id}`	Bir işin durumu ve sonucu.
GET	`/v1/stock/summary`	Elinizdekiler, oyun ve paket bazında.
POST	`/v1/order/screenshot`	Mağazanın sipariş onayı, PNG olarak.
GET	`/v1/me · /v1/quota · /v1/history · /v1/players`	Hesap, kalan hak, geçmiş siparişler, kayıtlı oyuncular.
POST	`/v1/subscription/purchase · purchase-api-addon`	USDT bakiyenizden plan satın alın veya uzatın.

Oyunlar

Aynı yollar her oyun için çalışır — yalnızca game değiştirin. Paketler ve örnekler API başvurusunda ve oyun sayfalarında.

`freefire`	yükleme · kod kontrolü · oyuncu sorgusu
`pubg`	yükleme · kod kontrolü · oyuncu sorgusu
`ludo` / `ludogold`	`tier` ile yükleme · oyuncu sorgusu · kod kontrolü yok
`jawaker`	yükleme · oyuncu sorgusu · kod kontrolü yok

Günlük hak

Her planın UTC gece yarısında sıfırlanan ve planın kapsadığı oyunların paylaştığı günlük bir hakkı vardır. Yükleme kod başına 1 istek, kod kontrolü kart başına 1, oyuncu sorgusu 0,25'tir. Mağazanın reddi sayılır; bizim tarafımızdaki bir hata hakkınıza otomatik geri döner. Bot ve API aynı hakkı paylaşır.

Hatalar

Doğrulama detail.error içinde bir kodla 400 döner; kimlik 401 veya 403; çok fazla çağrı 429. Güvenli yeniden başlatmada yeni işler 503 SERVICE_DRAINING döner — biraz sonra yeniden deneyin. Tam liste tam başvurudadır.

İstek hataları

401		API anahtarı eksik, hatalı veya yeni bir anahtarla değiştirilmiş. Bottan yeniden kopyalayın.
403		API eklentili aktif plan yok. Botta yenileyin.
403	`GAME_NOT_IN_PLAN`	Planınız bu oyunu kapsamıyor. Oyunu botta planınıza ekleyin.
400	`INVALID_CODE`	Bu oyun için geçerli bir kod değil. Hiçbir şey gönderilmedi veya ücretlendirilmedi.
400	`INVALID_PLAYER_ID`	Bu oyun için geçerli bir oyuncu ID'si değil. Hiçbir şey gönderilmedi veya ücretlendirilmedi.
400	`INSUFFICIENT_BALANCE`	Bakiyeniz fiyatı karşılamıyor. Botta bakiye yükleyin.
429	`QUOTA_EXHAUSTED`	Bugün yeterli istek kalmadı. UTC gece yarısında veya plan alınca yenilenir.
429	`RATE_LIMIT`	Çok fazla çağrı. Retry-After süresi kadar bekleyip yeniden deneyin.
503	`SERVICE_DRAINING`	Kısa bakım. Hiçbir şey sıraya alınmadı; birkaç saniye sonra yeniden deneyin.

Kart sonuçları (err_code)

`CODE_ALREADY_USED`	Kart zaten kullanılmış. Yeniden denemeyin.
`INVALID_CODE`	Mağaza kartı tanımıyor. Nasıl yazıldığını kontrol edin.
`REGION_MISMATCH`	Kart oyuncudan farklı bir bölge için.
`PLAYER_NOT_FOUND`	Bu ID ile hesap yok. Kartlar kullanılmadı.
`NETWORK`	Sonuç belli olmadan geçici bir sorun. İade edildi; aynı kodu yeniden deneyin.

Bölgeler

Neredeyse her ülkenin oyuncuları desteklenir. Garena'nın hiç kupon satmadığı yerlerde — ABD, Arjantin, Şili ve Rusya — oyuncu sorgusu, tek bir kod riske girmeden 422 UNSUPPORTED_REGION döner.