Начало работы
Аутентификация
Передавайте ключ в параметре запроса api_key в каждом запросе и отправляйте заголовок Accept: application/json, чтобы ошибки тоже возвращались в JSON.
Запрос принимается, только если ключ существует, подписка активна и не истекла, для ключа включён хотя бы один источник, а IP вызывающей стороны входит в белый список, если он настроен. Каждая неудача возвращает 403 с конкретным сообщением:
| error | Что исправить |
|---|---|
please add your api_key in get param | В строке запроса нет ключа. |
wrong api key | Ключ введён с ошибкой или отозван. |
your api subscription has expired | Продлите подписку. |
your api subscription is not active | Попросите поддержку активировать ключ. |
ip address is not in whitelist | Отправляйте запросы с IP из белого списка. Ответ содержит ip, который мы видим. |
you don't have any data in your subscription | Для этого ключа не включено ни одного источника. |
authentication service temporarily unavailable | Статус 503. Повторите запрос через Retry-After секунд (5). |
Вызывайте API со своего сервера. Ответы не содержат CORS-заголовков, поэтому браузеры блокируют прямые вызовы, а ключ во фронтенд-коде может прочитать кто угодно. Проксируйте запросы через свой бэкенд. next_url в экспорте тоже содержит ваш ключ, поэтому не пишите его в логи и не показывайте публично.
Аутентифицированный запрос
curl -g "https://api.lotarius.com/domains?api_key=$CARS_API_KEY" \
-H "Accept: application/json"403 · нет ключаLive
{
"error": "please add your api_key in get param"
}