Pierwsze kroki
Uwierzytelnianie
Wysyłaj swój klucz jako parametr zapytania api_key w każdym żądaniu oraz nagłówek Accept: application/json, aby błędy również wracały jako JSON.
Żądanie jest przyjmowane tylko wtedy, gdy klucz istnieje, subskrypcja jest aktywna i nie wygasła, klucz ma co najmniej jedno włączone źródło, a IP wywołującego znajduje się na liście dozwolonych, jeśli ją skonfigurowano. Każdy błąd zwraca 403 z konkretnym komunikatem:
| error | Co naprawić |
|---|---|
please add your api_key in get param | Brak klucza w query stringu. |
wrong api key | Klucz zawiera literówkę lub został unieważniony. |
your api subscription has expired | Odnów subskrypcję. |
your api subscription is not active | Poproś pomoc techniczną o aktywację klucza. |
ip address is not in whitelist | Wywołuj z IP z listy dozwolonych. Odpowiedź zawiera ip, które widzimy. |
you don't have any data in your subscription | Dla tego klucza nie włączono żadnych źródeł. |
authentication service temporarily unavailable | Status 503. Ponów po Retry-After sekundach (5). |
Wywołuj API ze swojego serwera. Odpowiedzi nie zawierają nagłówków CORS, więc przeglądarki blokują bezpośrednie wywołania, a klucz w kodzie front-endu może odczytać każdy. Przekazuj żądania przez swój backend. next_url w eksporcie również zawiera Twój klucz, więc nie zapisuj go w logach ani nie pokazuj publicznie.
Uwierzytelnione żądanie
curl -g "https://api.lotarius.com/domains?api_key=$CARS_API_KEY" \
-H "Accept: application/json"403 · brak kluczaNa żywo
{
"error": "please add your api_key in get param"
}