Endpoint pengesahan dan akaun

Setiap permintaan hanya membawa satu header. GET /account ialah endpoint untuk membuktikan kunci berfungsi, membaca baki dompet yang digunakan untuk pesanan anda, dan memastikan akaun aktif sebelum anda memulakan larian kelompok.

Cara permintaan disahkan

Header Authorization membawa bukti kelayakan Bearer dalam bentuk ID kunci dan rahsia yang dicantumkan dengan titik. ID kunci menentukan akaun, manakala rahsia disemak melalui perbandingan HMAC. Jika semakan gagal, respons 401 dengan MISSING_API_KEY atau INVALID_API_KEY dipulangkan sebelum laluan itu sendiri dijalankan. Tiada perkara lain yang diperiksa: tiada cookie, tiada token CSRF, tiada header origin.

Senarai IP dibenarkan

Kunci boleh diikat pada satu set alamat sumber. Selagi senarai itu tidak kosong, permintaan dari alamat lain ditolak dengan IP_NOT_ALLOWED dan HTTP 403, sebelum had kadar dan sebelum sebarang semakan dompet. Jadi, bukti kelayakan yang dicuri tidak boleh digunakan di luar infrastruktur anda sendiri. Senarai kosong bermaksud kunci boleh digunakan dari mana-mana lokasi.

Status akaun

Satu keadaan di peringkat akaun menghentikan semua endpoint serta-merta: akaun yang dibekukan menjawab ACCOUNT_FROZEN dengan HTTP 403. Status ini tidak hilang dengan sendirinya, jadi serahkan kepada seseorang untuk diuruskan dan jangan cuba semula berulang kali dalam gelung.

Putaran kunci

Kunci dicipta dan dipadam di halaman API Access dalam panel reseller. Rahsia hanya dipaparkan sekali semasa kunci dicipta, jadi putaran dibuat dengan cipta, lancarkan, kemudian padam, bukan dengan mengedit kunci sedia ada. Bukti kelayakan tidak tamat tempoh dengan sendirinya, maka jadual putaran terpulang kepada anda.

GET

/account

Dapatkan maklumat akaun

Dapatkan maklumat akaun yang terperinci, termasuk baki dompet, status akaun dan tarikh akaun dibuat.

Had kadar60 permintaan / 60 saat setiap akaun

Permintaan

curl -s "https://shop2topup.com/api/endpoints/v1/account" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Contoh respons

{
  "success": true,
  "account": {
    "id": 42,
    "email": "[email protected]",
    "username": "partner_store",
    "client_type": "reseller",
    "wallet": "1250.500000",
    "enabled": true,
    "verified": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}

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

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.