Tests et validation
Stratégies de test, contrats de test, prévisualisation et checklist d'intégration.
Clé de développement
Votre clé de développement utilise la même URL que la clé de production (https://api.mytulip.io/v2). Les contrats créés avec cette clé n'ont aucun impact financier. Voir Environnements pour les détails.
Contrats de test
Le mode test est un paramétrage de compte configuré par Tulip. Lorsqu'il est activé sur votre compte, tous les contrats créés sont automatiquement marqués comme contrats de test — aucun paramètre supplémentaire n'est nécessaire dans vos requêtes.
Contactez Tulip pour activer ou désactiver le mode test sur votre compte.
Les contrats de test sont filtrables via ?test=true dans les listes.
Prévisualisation
Utilisez ?preview=true sur les endpoints de création, modification et résiliation pour simuler l'opération sans l'exécuter :
# Simuler la création d'un contrat
POST /v2/contracts?preview=true
# Simuler une résiliation
DELETE /v2/contracts/{id}?preview=trueLa réponse contient le résultat tel qu'il serait, y compris le prix calculé.
Checklist d'intégration
Contrats
- Créer un contrat LCD avec les options minimales (
break,theft) - Créer un contrat LMD avec option
company - Créer un contrat LLD avec option
individual - Modifier un contrat (dans la fenêtre de 4h)
- Résilier un contrat
- Ajouter/supprimer un produit
- Tester le mode
preview
Sinistres
- Créer une pré-déclaration (vol total vélo)
- Uploader des documents (JSON base64)
- Vérifier
canSubmitavant soumission - Soumettre le sinistre
- Tester l'annulation (DELETE depuis draft)
- Récupérer un document avec URL signée
Erreurs
- Requête sans clé API → erreur 9001
- Clé API invalide → erreur 9002
- Contrat non trouvé → erreur 1051
- Modification après 4h → erreur 1050
- Documents incomplets à la soumission → erreur 3004
Webhooks
- Configurer un webhook depuis l'espace développeur
- Vérifier la réception des événements
- Tester l'idempotence de votre handler
Que pensez-vous de cette page ?