Espace développeur
Gérer vos clés API, consulter les logs d'appels et configurer vos webhooks depuis l'interface Colibri.
L'interface Colibri met à disposition un espace développeur accessible depuis le menu latéral (section Développeur). Cet espace vous permet de gérer votre intégration API en autonomie.
L'espace développeur n'est visible que pour les utilisateurs ayant le rôle propriétaire d'API. Si vous ne voyez pas la section « Développeur » dans le menu, contactez votre administrateur de compte.
Clés API
La page principale de l'espace développeur affiche vos clés API :
- Identifiant de chaque clé (partiellement masqué pour la sécurité)
- Nom et date de dernière mise à jour
- Accès direct aux logs de chaque clé
Votre clé API est également accessible depuis Profil > Paramètres > Intégration API avec un bouton de copie rapide.
Votre clé API est confidentielle — Ne la partagez jamais dans du code client ou des dépôts publics. Utilisez des variables d'environnement pour la stocker. En cas de compromission, contactez immédiatement le support.
Logs des appels API
L'onglet Appels vous donne une vue complète de toutes les requêtes effectuées vers l'API Tulip :
Filtrage
- Méthode HTTP : GET, POST, PATCH, DELETE
- Code de statut HTTP
- Code d'erreur Tulip
- Plage de dates (du / au)
- Recherche libre par identifiant
Détail d'un appel
Pour chaque appel, vous pouvez consulter :
| Champ | Description |
|---|---|
| Statut HTTP | Code de retour avec indicateur visuel (succès/erreur) |
| Méthode | GET, POST, PATCH ou DELETE |
| Chemin | URL de l'endpoint appelé |
| Durée | Temps de réponse en millisecondes |
| Horodatage | Date et heure de la requête |
| Identifiant d'exécution | Référence unique pour le support |
| Paramètres de requête | Query parameters envoyés (JSON) |
| Corps de la requête | Body envoyé (JSON) |
| Réponse | Corps de la réponse retournée (JSON) |
L'identifiant d'exécution (execution_id) est retourné dans chaque réponse API. Communiquez-le au support pour faciliter le diagnostic en cas de problème.
Gestion des webhooks
L'onglet Webhooks vous permet de créer et gérer vos webhooks en autonomie, sans contacter le support.
Créer un webhook
Pour chaque webhook, configurez :
- Nom : identifiant libre pour reconnaître le webhook
- URL de callback : l'endpoint HTTPS qui recevra les notifications
- Événements : sélectionnez les événements souhaités parmi 5 catégories (contrats, pré-déclarations, sinistres, documents, règlements)
- Statut : actif ou inactif (vous pouvez désactiver un webhook sans le supprimer)
Pour la liste complète des événements disponibles, consultez la page Webhooks.
Consulter les logs de livraison
Pour chaque webhook, un historique détaillé des livraisons est disponible :
| Champ | Description |
|---|---|
| Statut | Succès, erreur ou en attente de retry |
| Événement | Type d'événement (v2.contract.created, etc.) |
| Code de réponse | Code HTTP retourné par votre endpoint |
| Durée | Temps de réponse de votre endpoint |
| Tentative | Numéro de la tentative (1ère, 2ème, 3ème) |
| Prochaine tentative | Date du prochain retry (si en attente) |
| Payload | Corps envoyé à votre endpoint (JSON) |
| Réponse | Corps retourné par votre endpoint (JSON) |
Rejouer ou annuler
- Rejouer : relancer la livraison d'un webhook échoué
- Annuler : abandonner une tentative de retry en attente
Ces actions sont disponibles directement depuis le détail de chaque livraison.
Voir aussi
- Authentification — Obtenir et utiliser votre clé API
- Webhooks — Liste des événements, format des payloads et bonnes pratiques
- Environnement de test — Tester votre intégration en sandbox
Que pensez-vous de cette page ?