Ключи и заголовки
Ключи
| Ключ | Где взять | Ограничения |
|---|---|---|
la_live_ + 32 символа | Кабинет → Сайты: один ключ на сайт | только с IP сервера сайта, только оплаченные базы |
la_test_ + 32 символа | Кабинет → Песочница: один на аккаунт | любые IP, выдуманные данные, 1 000 запросов в сутки |
Ключ показывается один раз при выпуске — мы храним только его хэш. Потеряли ключ — выпустите новый в кабинете, старый сразу перестанет работать.
Заголовки запроса
| Заголовок | Значение | |
|---|---|---|
X-Api-Key | обязателен | ключ сайта или песочницы |
X-Visitor-Ip | обязателен для методов баз | IP посетителя вашего сайта, для которого вы делаете запрос (IPv4 или IPv6). Не IP сервера! |
X-Visitor-Ua | желательно | User-Agent посетителя — помогает точнее отличать ботов |
X-Visitor-Pass | если есть | пропуск капчи посетителя из куки la_pass |
Лимиты на посетителя считаются по X-Visitor-Ip. Если подставлять туда IP сервера или один и тот же адрес, все посетители сайта окажутся «одним человеком» и быстро упрутся в лимит.
Сайт за прокси или CDN: берите настоящий IP посетителя из заголовка, который ставит прокси (X-Real-IP, CF-Connecting-IP), а не из REMOTE_ADDR.
IP сервера
Боевой ключ принимает запросы только с IP, указанных в настройках сайта (до двух). С других адресов — ошибка 403 ip_not_allowed. Свой внешний IP можно узнать с сервера:
curl -s https://ifconfig.meИзменения IP и доменов в кабинете начинают действовать в течение 5 минут.
Ответ
{
"ok": true,
"data": [ … ],
"meta": { "base": "jp", "page": 1, "per_page": 20, "total": 318, "pages": 16, "sort": "date" }
}Заголовки ответа методов баз: X-RateLimit-Limit, X-RateLimit-Remaining (остаток суточного лимита по продукту), X-RateLimit-Reset (секунд до полуночи МСК).