UNLOCK API
API-ключ
API-ключі та безпека
MarkdownOpenAPI

API-ключі та безпека

Як надсилати ключ, використовувати кілька ключів і дозволити доступ лише своїм серверам.

Ваш ключ

Кожен запит містить API-ключ зі сторінки акаунта: clientKey у запитах JSON, key в in.php і res.php. Ключ має 32 символи (0-9, a-f). Зберігайте його на своєму сервері: будь-хто, хто має ключ, може витрачати ваш баланс.
POST /getBalance
{
  "clientKey": "YOUR_API_KEY"
}

Додаткові ключі

На сторінці акаунта можна створити до 5 додаткових ключів, наприклад по одному на сервер чи проєкт. Вони мають спільний баланс, показують час останнього використання, і їх можна вимикати окремо.

Список дозволених IP

Додайте до 20 IP-адрес на сторінці акаунта, і лише ці адреси зможуть використовувати ваші ключі. Запити з інших адрес отримують ERROR_IP_NOT_ALLOWED, кошти не списуються.
Помилка
{
  "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."
}

Виклики з браузера

in.php і res.php додають заголовок CORS Access-Control-Allow-Origin: *, якщо ви надсилаєте header_acao=1. Виклик API з публічної вебсторінки розкриває ваш ключ, тому використовуйте це лише для власних інструментів.