Demandes d'intégration
Demandes d'intégration
Une Demande d'Intégration est une trace d'un échange entre votre site et un service externe. Les applications de Dokos en créent une, par exemple, pour un paiement en ligne ou pour un webhook reçu d'une passerelle de paiement. Vous ne créez pas ces documents vous-même : vous les consultez pour comprendre un échec.
Ne confondez pas avec le Webhook, qui envoie des données depuis votre site vers un autre service.
Consulter les demandes
- Ouvrez la recherche (Ctrl+K) et saisissez Demande d'Intégration.
- Filtrez la liste sur le Statut ou le Service (par exemple le nom de la passerelle de paiement).
- Ouvrez une demande pour lire son contenu.
Champs
| Champ | Contenu |
|---|---|
| Service | Service externe concerné. |
| Statut | En file d'attente, Autorisé, Terminé, Annulé, Échec ou Non géré. |
| Description de la demande | Type d'échange, par exemple Webhook. |
| S'agit-il d'une demande à distance ? | Coché quand la demande vient du service externe (webhook reçu). |
| ID de la demande | Identifiant donné par le service externe. |
| URL | Adresse appelée. |
| Données de la requête / En-têtes de requêtes | Contenu envoyé ou reçu, au format JSON. |
| Résultat / En-têtes de réponse | Réponse du service. |
| Erreur | Message d'erreur. Si c'est une trace Python, elle s'affiche en rouge en haut du formulaire. |
| Type de document de référence / Nom du document de référence | Document Dokos lié, par exemple une demande de paiement. |
| Type de document du service, ID du document du service, Statut du service | Références de l'objet chez le service externe. |
Actions sur une demande
Le menu Actions du formulaire propose :
- Changer le statut à 'Terminé' : marque une demande comme traitée, quand vous l'avez réglée à la main.
- Réessayer de traiter le webhook : relance le traitement d'un webhook reçu qui n'est pas terminé.
- Réinitialiser ce webhook : pour un webhook terminé, remet le statut à En file d'attente et efface la référence et l'erreur.
Les deux actions sur les webhooks ne s'affichent que pour une Description de la demande Webhook ou Subscription Notification.
Conservation
Les demandes d'intégration sont supprimées après 90 jours par défaut. Vous pouvez changer ce délai dans les Paramètres des journaux.
Le nombre de demandes en Échec s'affiche dans les notifications des utilisateurs qui ont accès à ce document.
Exemple
Exemple fictif. Un client a payé en ligne, mais sa demande de paiement n'est pas marquée comme payée.
- Ouvrez la liste Demande d'Intégration et filtrez sur le Statut Échec.
- Ouvrez la demande dont le Nom du document de référence est la demande de paiement du client.
- Lisez le champ Erreur, corrigez la cause (par exemple une clé d'API expirée).
- Cliquez sur Actions > Réessayer de traiter le webhook.