Erreurs

L'objet d'erreur

Chaque échec a la même forme, quelle qu'en soit la cause :

403
{
  "error": {
    "code": "scope_required",
    "message": "This key is not allowed to perform that action.",
    "details": {
      "scope": "keywords:write"
    }
  },
  "request_id": "req_d3428e686099bb0e"
}

code

StatutcodeSignification
401missing_api_keyAucune clé n'a été envoyée
401invalid_api_keyClé inconnue ; cherchez la faute de frappe
401key_revokedLa clé existait et a été révoquée ; adressez-vous à qui l'a émise
402plan_limitUn plafond de l'offre est atteint. details.resource vaut targets ou keywords, avec limit et current
403scope_requiredLa clé ne possède pas une portée ; details.scope la nomme
404not_subscribedVous ne surveillez pas ce compte ; une résolution échouée ajoute details.state: "failed", details.reason et details.failed_at
404user_not_foundX n'a pas de tel compte : jamais inscrit, supprimé ou désactivé
404user_suspendedX a suspendu ce compte
404user_protectedLes publications du compte sont protégées (abonnés approuvés uniquement), il ne peut donc pas être surveillé
404tweet_not_foundPas de telle publication, ou elle a été supprimée
404not_foundPas de telle ressource
409idempotency_key_reuseLa même Idempotency-Key a déjà été utilisée avec une requête différente
409conflictLa ressource est dans un état qui interdit la modification ; details.reason en donne la raison
422invalid_requestLe corps ou la requête a échoué à la validation. En 422, details.fields nomme chaque champ fautif ; en 400, une valeur que nous avons pu analyser mais pas accepter
429rate_limitedVotre budget de requêtes par minute est épuisé ; Retry-After dit quand
429quota_exhaustedLa limite en amont pour cette lecture a été atteinte ; Retry-After dit quand
502upstreamX n'a pas répondu comme prévu. Généralement transitoire ; réessayez
500internalC'est de notre faute. Envoyez-nous le request_id