Documentation Genesis API

Tout pour intégrer : authentification, limites, endpoints et schémas de réponse.

Erreurs

Les erreurs renvoient le statut HTTP correspondant avec un corps :

json
{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "Requests per second limit exceeded."
  }
}
HTTPCodeDescription
400bad_requestParamètres de requête invalides — détails dans message
401invalid_keyClé absente, invalide ou révoquée, ou le plan API a expiré
403plan_restrictedL'endpoint n'est pas inclus dans votre plan
404not_foundEndpoint ou ressource introuvable
410goneL'endpoint est retiré — le remplacement est indiqué dans message
429rate_limitedLimite dépassée — voir X-RateLimit et Retry-After
429download_limitedVolume de téléchargement dépassé : 60 Mo de données compressées par tranche de 10 secondes et par clé — voir Retry-After
500internal_errorErreur interne, réessayez plus tard
503snapshot_not_readyLes données sont en cours de reconstruction ou leur source redémarre — réessayez dans quelques secondes, voir Retry-After

Chaque réponse contient l'en-tête X-Request-Id. Pour contacter le support, indiquez-le avec l'heure de la requête en UTC, l'endpoint et le statut — jamais votre clé.