Початок роботи
Автентифікація
Надсилайте свій ключ у параметрі запиту 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 · немає ключаНаживо
{
"error": "please add your api_key in get param"
}