Limites et erreurs
Chaque réponse porte X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset : vous voyez une limite venir au lieu de la découvrir.
Les quotas
Une clé gratuite, c'est 100 requêtes par jour, remises à zéro à minuit UTC ; le lendemain reprend à l'identique, rien à renouveler. Pro, c'est 5 000 par jour, Business 25 000, et Enterprise est sans plafond en usage raisonnable.
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1761264000| status | meaning |
|---|---|
| 200 | A normal answer. Check X-RateLimit-Remaining while you are here. |
| 400 | A parameter could not be parsed — a non-numeric yearFrom, for instance. |
| 401 | Missing or unknown key. Send it as the x-api-key header. |
| 404 SOLD_OR_REMOVED | From /car: the vehicle is gone from Encar. Drop it on your side. |
| 429 | Daily allowance spent. X-RateLimit-Remaining tells you before it happens. |
| 503 | The Korean source did not answer in time. Retry once, then fall back. |
Gérer une voiture vendue
C'est l'erreur qui mérite du code. GET /car vérifie la disponibilité en direct : un véhicule parti d'Encar répond 404 avec le code SOLD_OR_REMOVED. Traitez-le comme un signal de dépublication chez vous, pas comme un échec à réessayer — demain renverra le même 404.
HTTP/1.1 404 Not Found
{ "error": "SOLD_OR_REMOVED", "id": "38421907" }Obtenez votre clé API
Gratuit · 100 requêtes par jour
À lire ensuite
Combinez-les librement en un seul appel. La réponse porte total, page, count et results[], vous pouvez donc paginer sur total sans seconde requête.
Les données viennent d'une source coréenne : quatre de ces champs sont donc lus de travers par défaut. Chaque erreur est silencieuse — votre page s'affiche, elle est simplement fausse.
Un montant par mois, aucune facturation à l'appel à prévoir et aucun frais de mise en service. L'offre gratuite est une vraie offre, pas un essai qui expire.