--- title: "Webhooks de l'API Surfer" description: "Évitez le sondage en boucle. Découvrez comment configurer des webhooks pour que Surfer notifie votre serveur dès qu'un Éditeur de contenu est prêt, qu'un article généré par l'IA est terminé ou qu'une exécution d'Auto-optimisation est terminée, sans aucune requête GET répétée." url: https://docs.surferseo.com/fr/articles/12944183-webhooks-de-l-api-surfer collection: "API" updated: 2026-10-02 language: fr alternates: [en, de] --- # Webhooks de l'API Surfer Évitez le sondage en boucle. Découvrez comment configurer des webhooks pour que Surfer notifie votre serveur dès qu'un Éditeur de contenu est prêt, qu'un article généré par l'IA est terminé ou qu'une exécution d'Auto-optimisation est terminée, sans aucune requête GET répétée. Les webhooks permettent à Surfer de notifier votre serveur au moment où quelque chose se produit, comme la fin du traitement d'un Éditeur de contenu ou la fin d'une exécution d'Auto-optimisation, afin que vous n'ayez pas à sonder les mises à jour en continu. * * * ## Configuration des webhooks La configuration des webhooks est gérée par l'équipe d'assistance. Pour commencer : 1. Configurez un point de terminaison HTTPS de votre côté, qui accepte les requêtes **POST** et répond avec **HTTP 200 OK**. 2. Contactez l'assistance Surfer par email ou chat en direct et partagez l'URL. 3. L'assistance enregistrera le point de terminaison et vous enverra une **Verification-Key** à utiliser pour authentifier les requêtes entrantes de votre côté. Une fois configuré, Surfer enverra une requête POST à votre point de terminaison chaque fois qu'un événement pris en charge se déclenche. Chaque requête inclut un en-tête `Verification-Key` et un corps JSON. * * * ### Structure de la charge utile du webhook Tous les événements webhook suivent la même enveloppe : ```json { "id": 123, "type": "event.name.here", "timestamp": "2024-06-01T12:00:00Z", "payload": { ... } } ```

Champ	Type	Description
`id`	entier	Identifiant de notification unique
`type`	chaîne de caractères	Nom de l'événement (voir la liste complète ci-dessous)
`timestamp`	chaîne de caractères	Horodatage UTC ISO8601 du moment où l'événement s'est produit
`payload`	objet	Données spécifiques à l'événement (varient selon le type d'événement)

* * * ## Événements pris en charge ### Initialisation de l'Éditeur de contenu Se déclenche après que `POST /api/v2/workspaces/{workspace_id}/content_editors` termine le traitement.

Événement	Quand il se déclenche
`content_editor.initialization.completed`	L'éditeur de contenu est prêt à être utilisé
`content_editor.initialization.failed`	Le traitement a échoué

Champs de charge utile : `draft_id` (entier), `permalink_hash` (chaîne de caractères) ```json { "id": 123, "type": "content_editor.initialization.completed", "timestamp": "2024-06-01T12:00:00Z", "payload": { "draft_id": 5632898, "permalink_hash": "kKi7n3pkRk7Gw5cxKDiBAbCAybnDTt2z" } } ``` * * * ## Recalcul du Content Score Se déclenche après que vous avez mis à jour le contenu d'un Éditeur de contenu via l'API.

Événement	Quand il se déclenche
`content_editor.content_score.recalculated`	Score mis à jour après une modification de contenu

Champs de charge utile : `draft_id` (entier), `permalink_hash` (chaîne de caractères), `content_score` (entier) ```json { "id": 124, "type": "content_editor.content_score.recalculated", "timestamp": "2024-06-01T12:05:00Z", "payload": { "draft_id": 5632898, "permalink_hash": "kKi7n3pkRk7Gw5cxKDiBAbCAybnDTt2z", "content_score": 74 } } ``` * * * ### Génération d'articles par IA Se déclenche pendant et après la génération d'articles Surfer AI.

Événement	Quand il se déclenche
`content_editor.ai_article.completed`	Article complet généré
`content_editor.ai_article.waiting_for_user_input`	Le plan est prêt et en attente d'examen (uniquement quand `manual_outline: true`)
`content_editor.ai_article.failed`	La génération a échoué

Champs de charge utile : `draft_id` (entier), `permalink_hash` (chaîne de caractères) * * * ## Auto-optimisation Se déclenche après la fin, l'échec ou l'annulation d'une exécution d'Auto-optimisation.

Événement	Quand il se déclenche
`content_editor.auto_optimize.completed`	Exécution terminée
`content_editor.auto_optimize.failed`	Exécution échouée
`content_editor.auto_optimize.cancelled`	L'exécution a été annulée

Champs de charge utile : `job_id` (entier), `draft_id` (entier), `result` (chaîne de caractères, uniquement sur `completed`) Le champ `result` vaut soit `"optimized"` (le contenu a été modifié), soit `"nothing_to_optimize"` (le contenu était déjà bien optimisé). ```json { "id": 125, "type": "content_editor.auto_optimize.completed", "timestamp": "2024-06-01T12:10:00Z", "payload": { "job_id": 456, "draft_id": 5632898, "result": "optimized" } } ``` * * * ### Score SEO (V2 uniquement)

Événement	Quand il se déclenche
`content_editor.seo_score.calculated`	Le Score SEO a été calculé
`content_editor.seo_score.failed`	Le calcul du Score SEO a échoué

* * * ### Score de recherche IA (V2 uniquement)

Événement	Quand il se déclenche
`content_editor.ai_search_score.calculated`	Score de recherche IA calculé
`content_editor.ai_search_score.failed`	Échec du calcul du score de recherche IA

* * * ### Génération de plan (V2 uniquement)

Événement	Quand il se déclenche
`content_editor.outline.completed`	Génération du plan terminée
`content_editor.outline.failed`	Échec de la génération du plan

* * * ### Chargement des concurrents (V2 uniquement)

Événement	Quand il se déclenche
`content_editor.seo_guidelines.competitors.load_more.completed`	Concurrents supplémentaires chargés
`content_editor.seo_guidelines.competitors.load_more.failed`	Le chargement des concurrents supplémentaires a échoué

* * * ## Référence complète des événements

Événement	S'applique à
`content_editor.initialization.completed`	V1 + V2
`content_editor.initialization.failed`	V1 + V2
`content_editor.content_score.recalculated`	V1 + V2
`content_editor.ai_article.completed`	V1 + V2
`content_editor.ai_article.waiting_for_user_input`	V1 + V2
`content_editor.ai_article.failed`	V1 + V2
`content_editor.auto_optimize.completed`	V1 + V2
`content_editor.auto_optimize.failed`	V1 + V2
`content_editor.auto_optimize.cancelled`	V1 + V2
`content_editor.seo_score.calculated`	V2 uniquement
`content_editor.seo_score.failed`	V2 uniquement
`content_editor.ai_search_score.calculated`	V2 uniquement
`content_editor.ai_search_score.failed`	V2 uniquement
`content_editor.outline.completed`	V2 uniquement
`content_editor.outline.failed`	V2 uniquement
`content_editor.seo_guidelines.competitors.load_more.completed`	V2 uniquement
`content_editor.seo_guidelines.competitors.load_more.failed`	V2 uniquement

* * * ## **Ressources supplémentaires :** [Introduction à l'API Surfer](https://docs.surferseo.com/en/articles/5700335-surfer-api-introduction.md) [Documentation de l'API Surfer (v1)](https://app.surferseo.com/api/v1/docs#section/Introduction) [Documentation de l'API Surfer (v2)](https://app.surferseo.com/api/v2/docs) [Exemples d'utilisation de l'API Surfer](https://docs.surferseo.com/en/articles/8201326-surfer-api-examples-of-use.md)