API Ephemeris
Dane produktów z kodów EAN i GTIN dla Twojej aplikacji — tylko do odczytu.
Adres bazowy
Wszystkie zapytania wysyłasz pod ten adres:
https://api.ephemeris.coruls.com/v1Uwierzytelnienie
Każde zapytanie ma nagłówek z kluczem API:
Authorization: Bearer <klucz>Licencja
Dane możesz wykorzystywać w aplikacjach, także komercyjnych, jeśli wskażesz źródło. Nie wolno ich odsprzedawać ani masowo kopiować bazy. Warunki są częścią regulaminu Coruls; akceptujesz je przy pierwszym kluczu.
Tekst źródła do umieszczenia w aplikacji:
Dane: Ephemeris (Coruls) — https://ephemeris.coruls.comLimity
Najwyżej 10 zapytań na sekundę — szybsze serie dostają odpowiedź 429.
Każda odpowiedź ma nagłówki limitu:
| Nagłówek | Znaczenie |
|---|---|
| X-RateLimit-Limit | dzienny limit konta |
| X-RateLimit-Remaining | ile zapytań zostało dziś |
| X-RateLimit-Reset | kiedy limit się odnowi (sekundy Unix) |
Po wyczerpaniu limitu API odpowiada 429 z nagłówkiem Retry-After — liczbą sekund do odnowienia.
Błędy
Odpowiedź z błędem ma kod i opis po polsku:
{
"error": {
"code": "not_found",
"message": "Nie ma produktu o kodzie 5907654321015."
}
}| Status | Kod | Znaczenie |
|---|---|---|
| 400 | invalid_code | kod nie przechodzi walidacji, opis jak w wyszukiwarce (np. zła cyfra kontrolna) |
| 400 | invalid_category | nie ma kategorii o tym identyfikatorze (parametr category wyszukiwania) |
| 401 | unauthorized | brak klucza albo nieznany klucz |
| 403 | key_blocked | klucz zablokował administrator Ephemeris |
| 404 | not_found | nie ma produktu o tym kodzie |
| 429 | rate_limited | wykorzystano limit — zobacz nagłówek Retry-After |
| 500 | server_error | błąd po stronie Ephemeris — spróbuj ponownie za chwilę |
| 503 | maintenance | trwają prace serwisowe — ponów po czasie z nagłówka Retry-After |
| 503 | unavailable | API chwilowo nie odpowiada — ponów po czasie z nagłówka Retry-After |
Przykłady
Zapytanie o jogurt naturalny (5901234123457):
curl -H "Authorization: Bearer $EPHEMERIS_KEY" \
"https://api.ephemeris.coruls.com/v1/products/5901234123457"