Codes d’erreur

Toutes les erreurs suivent la RFC 9457 (application/problem+json). Votre code s’appuie sur le champ code, stable ; le titre est traduit et peut évoluer.

• unauthenticated Jeton absent, invalide ou expiré.
• forbidden Action refusée pour ce jeton.
• token.missing_scope Le jeton ne porte pas le scope requis.
• api.not_in_plan L'API n'est pas incluse dans votre offre.
• api.write_not_in_plan L'écriture par l'API n'est pas incluse dans votre offre.
• plan_limit Limite de votre offre atteinte.
• rate_limited Débit de votre offre dépassé, réessayez plus tard.
• not_found Ressource introuvable.
• method_not_allowed Méthode HTTP non prise en charge par cette route.
• validation_failed La requête contient des valeurs invalides.
• pagination.invalid_cursor Curseur de pagination invalide, ou émis pour une autre requête.
• idempotency.key_required Cette écriture exige un en-tête Idempotency-Key.
• idempotency.key_invalid En-tête Idempotency-Key invalide (1 à 255 caractères ASCII visibles).
• idempotency.key_reused Cette Idempotency-Key a déjà servi à une autre requête.
• idempotency.in_progress Une requête portant cette Idempotency-Key est encore en cours.
• project.locked Projet en lecture seule : votre offre ne couvre plus ce projet. Rien n’y est exécuté, tout y reste lisible.
• project.not_configured Projet incomplet : déclarez son modèle d’activité et créez une campagne avant de lancer un crawl.
• crawl.already_running Un crawl est déjà en cours pour cette équipe ; il s’exécute un crawl à la fois.
• crawl.already_finished Ce crawl est déjà terminé.
• crawl.target_refused La cible de la campagne n’est pas une adresse publique.
• crawl.no_baseline Aucun crawl comparable comme référence : un crawl tronqué n’en est jamais une.
• recommendations.no_data Aucune source de données pour ce projet : lancez un crawl, ou branchez Search Console ou vos journaux.
• export.crawl_not_finished Ce crawl n’est pas terminé : son rapport serait incomplet.
• export.not_ready L’export n’est pas encore prêt.
• export.expired L’export a expiré ; demandez-en un nouveau.
• positions.not_configured Le suivi de positions n’est pas configuré : choisissez d’abord le marché suivi.
• keywords.project_limit Plafond de mots-clés suivis atteint pour ce projet.
• keywords.not_tracked Ce mot-clé n’est pas suivi : ajoutez-le d’abord au suivi.
• keywords.paused Ce mot-clé est suspendu : reprenez-le avant de le vérifier.
• keywords.already_checked_today Ce mot-clé a déjà été vérifié aujourd’hui ; une vérification immédiate par mot-clé et par jour.
• bad_request Requête mal formée.
• conflict La requête entre en conflit avec l'état de la ressource.
• payload_too_large Corps de requête trop volumineux.
• unsupported_media_type Type de contenu non pris en charge.
• service_unavailable Service momentanément indisponible.
• internal_error Erreur interne. Elle a été journalisée.

Les refus de palier forment une famille : plan_limit suivi de la clé de l’offre concernée, par exemple plan_limit.projects.max. La réponse porte aussi entitlement et upgrade_to.

Référence de l’API Événements de webhook Documentation de l’API

Cette page en Markdown