Oyuncu doğrulama uç noktası

Oyuncu doğrulama, para hareket etmeden önce oyun içi hesabı çözümler. Kimliğin o ürün için var olduğunu doğrular, alıcınızın kontrol edebilmesi için oyun içi adı döndürür ve bölgeyi açığa çıkarır; böylece bölgeler arası bir sipariş, ödemeden sonra başarısız olmak yerine baştan reddedilir.

Hangi alanlar gönderilmeli

İstek gövdesi, sabit bir çift ile oyunun kendisinin gerektirdiği alanlardan oluşur. Önce GET /catalog/category/:categoryId/requirements adresini okuyun, ardından döndürdüğü her field_name değerini sub_category_id ve player_id ile birlikte gönderin. single_select veya multi_select türündeki alanlar yalnızca kendi select_options listesindeki bir değeri kabul eder. Eksik bir alan MISSING_REQUIRED_FIELD ile, alanın kurallarına uymayan bir değer ise INVALID_PARAMETER_FORMAT, INVALID_PARAMETER_VALUE veya INVALID_PARAMETER_LENGTH ile reddedilir; her iki durumda da details.field alanın adını verir.

Başarılı bir yanıt, kimliğin arkasındaki oyun içi adı ve bölgeyi döndürür. Bu bölgeyi satmak üzere olduğunuz ürünle karşılaştırın: uyuşmazlık REGION_MISMATCH ile reddedilir ve bunu doğrulama aşamasında yakalamak tek bir isteğe mal olurken, sipariş aşamasında yakalamak eksiksiz bir iade döngüsüne mal olur.

POST

/player/validate

Oyuncuyu Doğrula

Belirli bir oyun için oyuncu ID'sini doğrula. Kategori Gereksinimlerini Getir uç noktasının döndürdüğü dinamik gereksinim alanlarını da isteğe ekle.

Hız sınırıGünlük oyuncu kontrolü kotan (hesap başına). X-RateLimit başlıkları gönderilmez.

Not: Her oyunda hangi alanların gerektiğini öğrenmek için Kategori Gereksinimlerini Getir uç noktasını kullan. Zorunlu alanların hepsini istek gövdesine ekle. PLAYER_NOT_FOUND, oyunun bu ID'nin var olmadığını doğruladığı anlamına gelir. PLAYER_CHECK_UNAVAILABLE (HTTP 503, yeniden denenebilir) ise ID'nin şu an kontrol edilemediğini gösterir; ID reddedilmiş sayılmaz.

İstek gövdesi

Ad	Tür	Zorunlu	Açıklama	Örnek
sub_category_id	number	Evet	Ürünün alt kategori ID'si. Bulmak için Katalog Gezgini'ni kullan.	999
player_id	string	Evet	Oyun içi oyuncu ID'si.	123456789
...requirements	varies	Hayır	Kategori Gereksinimlerini Getir uç noktasından gelen ek alanlar. Her field_name'i anahtar, kullanıcının girdiği bilgiyi de değer olarak ekle.	"server": "Asia"

İstek

curl -s -X POST "https://shop2topup.com/api/endpoints/v1/player/validate" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "sub_category_id": 999,
  "player_id": 123456789
}'

Örnek yanıt

{
  "success": true,
  "player": {
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "region": "Asia"
  }
}

Bu sayfadan gerçek bir istek gönderin

Bu uç noktaları canlı çağırmak için bir API anahtarı yapıştırın. Anahtar bu tarayıcı sekmesinde kalır ve yalnızca API'nin kendisine gönderilir.

Enter your API key to use the interactive playground. Get your API key

Bir uç nokta seçin

sub_category_id *

Use Catalog Explorer to find this

No requirements for this category.

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Platformda yeni misiniz? bayiler için oyun yükleme API'sine genel bakış ile başlayın veya SHOP2TOPUP bayi programına genel bakış sayfasından iş ortağı hesabının nasıl çalıştığını okuyun.