Introduction
Bienvenue dans l'API Partenaire Vignetim (Partner API). Cette API vous permet d'integrer l'achat de vignettes, de forfaits de donnees eSIM et de produits d'assurance voyage directement dans votre plateforme.
URL de base
Toutes les requetes API sont envoyees a :
https://api.vignetim.com/v2/partners
L'API suit les conventions RESTful et retourne des reponses au format JSON. Toutes les requetes doivent etre authentifiees a l'aide de la signature de requete HMAC-SHA256.
Ce que vous pouvez faire
- Vendre des vignettes -- Parcourez les vignettes autoroutieres disponibles dans les pays europeens et creez des commandes pour le compte de vos clients.
- Vendre des forfaits eSIM -- Proposez des forfaits de donnees mobiles aux voyageurs, couvrant des destinations locales, regionales et mondiales.
- Vendre des assurances voyage -- Fournissez des produits d'assurance voyage avec differentes options de couverture.
- Gerer les commandes -- Suivez le statut des commandes, filtrez l'historique des commandes et recevez des notifications webhook en temps reel.
Versionnage
L'API Partenaire est versionnee via le chemin de l'URL (/v2/). Les changements non retrocompatibles (breaking changes) ne seront introduits que dans les nouvelles versions majeures. Les ajouts non destructifs (nouveaux champs, nouveaux endpoints) peuvent etre ajoutes a la version actuelle sans preavis.
Ressources pour les developpeurs
| Ressource | Lien |
|---|---|
| Specification OpenAPI (JSON) | vignetim.com/api/partner-openapi |
| Interface Swagger | api.vignetim.com/docs |
| Importer dans Postman | Copiez l'URL OpenAPI ci-dessus et utilisez File > Import > Link dans Postman |
| Serveur MCP | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Astuce : Importez la specification OpenAPI dans Postman, Insomnia ou tout autre client API pour obtenir des modeles de requetes preconfigures avec tous les endpoints et schemas prets a l'emploi.
Demarrage rapide
- Obtenez vos identifiants API -- Inscrivez-vous pour un compte partenaire et recuperez votre cle API et votre secret depuis le tableau de bord.
- Utilisez le bac a sable -- Commencez en mode bac a sable (sandbox) pour tester votre integration avec des paiements simules et sans frais reels.
- Authentifiez les requetes -- Signez chaque requete en utilisant HMAC-SHA256 avec les en-tetes requis.
- Parcourez les produits -- Recuperez les vignettes, forfaits eSIM ou produits d'assurance disponibles.
- Creez une commande -- Soumettez une commande avec la selection de produits, les details de paiement et les informations du client.
- Configurez les webhooks -- Enregistrez des endpoints webhook pour recevoir des notifications en temps reel sur les changements de statut des commandes.