API key và bảo mật

Cách gửi key, dùng nhiều key và chỉ cho phép máy chủ của bạn.

Key của bạn

Mọi request đều mang API key từ trang tài khoản: clientKey trong request JSON, key trong in.php và res.php. Key dài 32 ký tự (0-9, a-f). Hãy giữ key trên máy chủ của bạn; ai có key đều có thể tiêu số dư của bạn.

POST /getBalance

{
  "clientKey": "YOUR_API_KEY"
}

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

Thêm key

Bạn có thể tạo tối đa 5 key phụ trên trang tài khoản, ví dụ mỗi máy chủ hoặc mỗi dự án một key. Các key dùng chung số dư, hiển thị lần dùng gần nhất và có thể tắt từng key một.

Danh sách IP được phép

Thêm tối đa 20 địa chỉ IP trên trang tài khoản và chỉ những địa chỉ đó mới dùng được key của bạn. Request từ địa chỉ khác nhận ERROR_IP_NOT_ALLOWED và không bị tính phí.

Lỗi

{
  "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."
}

Gọi từ trình duyệt

in.php và res.php thêm header CORS Access-Control-Allow-Origin: * khi bạn gửi header_acao=1. Gọi API từ một trang web công khai sẽ làm lộ key, nên chỉ dùng cách này cho công cụ của riêng bạn.