Notifications d’état
Votre application peut recevoir des notifications sur l’état du rendu au lieu d’interroger à plusieurs reprises. Conservez l’ID de rendu et la recherche d’état afin de rapprocher les résultats.
1. Préparez un récepteur
Utilisez un point de terminaison HTTPS accessible publiquement, et non un réseau local/privé. Vérifier les signatures ; un corps d’apparence plausible ne constitue pas une preuve d’origine.
2. Créez un point de terminaison dans l’application
Ouvrez les Webhooks du projet, fournissez un nom et une URL, puis enregistrez le secret de signature en toute sécurité sur votre backend. Le secret est révélé lors de la création ; gardez-le à l’écart du code frontal et des captures d’écran.
3. Envoyer un test
Utilisez Test et inspectez l’état HTTP de la livraison, les tentatives et les erreurs. Un événement webhook.test n’est pas un PDF terminé.
4. Gérer les événements de rendu
Les notifications réelles utilisent renders.status. Conservez la réception en toute sécurité et répondez rapidement, puis effectuez un traitement plus long séparément. N’acquittez pas avant que votre système puisse conserver l’événement de manière fiable.
Utiliser le point de terminaison
Activer/désactiver délibérément et utiliser l’historique de livraison pour le diagnostic. Corrigez un point de terminaison existant plutôt que de créer des doublons. Lisez la vérification de la signature avant de traiter des données réelles.