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 с публичной веб-страницы раскрывает ваш ключ, поэтому используйте это только для своих инструментов.