Endpoint pengesahan pemain

Pengesahan pemain mencari akaun dalam game sebelum sebarang bayaran berlaku. Ia memastikan ID itu wujud untuk produk berkenaan, memulangkan nama dalam game supaya pembeli anda boleh menyemaknya, dan menunjukkan region supaya pesanan merentas region ditolak awal, bukan gagal selepas pembayaran.

Medan yang perlu dihantar

Body permintaan terdiri daripada satu pasangan tetap serta apa sahaja yang diperlukan oleh game itu. Baca GET /catalog/category/:categoryId/requirements dahulu, kemudian hantar setiap field_name yang dipulangkan bersama sub_category_id dan player_id. Medan jenis single_select atau multi_select hanya menerima nilai daripada senarai select_options masing-masing. Medan yang tiada ditolak dengan MISSING_REQUIRED_FIELD, manakala nilai yang melanggar peraturan medan ditolak dengan INVALID_PARAMETER_FORMAT, INVALID_PARAMETER_VALUE atau INVALID_PARAMETER_LENGTH. Dalam kedua-dua kes, details.field menyatakan nama medan tersebut.

Respons yang berjaya memulangkan nama dalam game dan region bagi ID tersebut. Bandingkan region itu dengan produk yang hendak anda jual. Jika tidak sepadan, permintaan ditolak dengan REGION_MISMATCH. Mengesannya semasa pengesahan hanya menggunakan satu permintaan, tetapi jika dikesan semasa pesanan, anda perlu melalui satu kitaran bayaran balik penuh.

POST

/player/validate

Sahkan pemain

Sahkan ID pemain bagi game tertentu. Sertakan medan keperluan dinamik yang dipulangkan oleh endpoint keperluan kategori.

Had kadarKuota semakan pemain harian anda (setiap akaun); tiada header X-RateLimit

Nota: Gunakan endpoint keperluan kategori untuk mengetahui medan yang diperlukan bagi setiap game. Sertakan semua medan wajib dalam badan permintaan. PLAYER_NOT_FOUND bermaksud game telah mengesahkan ID itu tidak wujud; PLAYER_CHECK_UNAVAILABLE (HTTP 503, boleh dicuba semula) bermaksud ID tidak dapat disemak buat masa ini dan tidak ditolak.

Body permintaan

Nama	Jenis	Wajib	Penerangan	Contoh
sub_category_id	number	Ya	ID subkategori produk. Gunakan Catalog Explorer untuk mencarinya.	999
player_id	string	Ya	ID pemain dalam game.	123456789
...requirements	varies	Tidak	Medan tambahan daripada endpoint keperluan kategori. Sertakan setiap field_name sebagai kunci bersama nilai yang diberikan oleh pengguna.	"server": "Asia"

Permintaan

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

Contoh respons

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

Hantar permintaan sebenar dari halaman ini

Tampal kunci API untuk memanggil endpoint ini secara langsung. Kunci itu kekal dalam tab pelayar ini dan hanya dihantar kepada API.

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

Pilih endpoint

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.

Jika anda baru di platform ini, mulakan dengan gambaran keseluruhan API top up game untuk reseller, atau baca gambaran keseluruhan program reseller SHOP2TOPUP untuk mengetahui cara akaun rakan kongsi berfungsi.