Първи стъпки
Удостоверяване
Изпращайте ключа си като параметър на заявката 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"
}