API key dan keselamatan

Cara menghantar key, menggunakan lebih daripada satu key dan membenarkan pelayan anda sahaja.

Key anda

Setiap permintaan membawa API key daripada halaman akaun anda: clientKey dalam permintaan JSON, key dalam in.php dan res.php. Key mempunyai 32 aksara (0-9, a-f). Simpan di pelayan anda; sesiapa yang ada key boleh membelanjakan baki anda.

POST /getBalance

{
  "clientKey": "YOUR_API_KEY"
}

https://unlock-api.com/res.php?key=YOUR_API_KEY&action=getbalance&json=1

Key tambahan

Anda boleh membuat sehingga 5 key tambahan di halaman akaun, contohnya satu bagi setiap pelayan atau projek. Key ini berkongsi baki, menunjukkan bila kali terakhir digunakan dan boleh dimatikan satu demi satu.

Senarai IP dibenarkan

Tambah sehingga 20 alamat IP di halaman akaun dan hanya alamat tersebut boleh menggunakan key anda. Permintaan dari alamat lain menerima ERROR_IP_NOT_ALLOWED dan tidak dicaj.

Ralat

{
  "errorId": 1,
  "errorCode": "ERROR_IP_NOT_ALLOWED",
  "errorDescription": "Requests from this IP are not allowed. Add it to the IP allow list on your account page."
}

Panggilan dari pelayar

in.php dan res.php menambah header CORS Access-Control-Allow-Origin: * apabila anda menghantar header_acao=1. Memanggil API dari halaman web awam akan mendedahkan key anda, jadi gunakan ini hanya untuk alat anda sendiri.