Introductie
Welkom bij de Vignetim Partner API. Met deze API kunt u vignetaankopen, eSIM-datapakketten en reisverzekeringen rechtstreeks in uw platform integreren.
Basis-URL
Alle API-verzoeken worden gedaan naar:
https://api.vignetim.com/v2/partners
De API volgt RESTful-conventies en retourneert JSON-antwoorden. Alle verzoeken moeten worden geauthenticeerd met HMAC-SHA256-verzoekondertekening (request signing).
Wat u kunt doen
- Vignetten verkopen -- Bekijk beschikbare snelwegvignetten in Europese landen en maak bestellingen aan namens uw klanten.
- eSIM-pakketten verkopen -- Bied mobiele datapakketten aan voor reizigers, met lokale, regionale en wereldwijde bestemmingen.
- Reisverzekeringen verkopen -- Bied reisverzekeringen aan met diverse dekkingsopties.
- Bestellingen beheren -- Volg de bestelstatus, filter de bestelgeschiedenis en ontvang realtime webhook-notificaties.
Versiebeheer
De Partner API wordt geversied via het URL-pad (/v2/). Brekende wijzigingen (breaking changes) worden alleen geïntroduceerd in nieuwe hoofdversies. Niet-brekende toevoegingen (nieuwe velden, nieuwe endpoints) kunnen zonder voorafgaande kennisgeving aan de huidige versie worden toegevoegd.
Ontwikkelaarsbronnen
| Bron | Link |
|---|---|
| OpenAPI Spec (JSON) | vignetim.com/api/partner-openapi |
| Swagger UI | api.vignetim.com/docs |
| Importeren in Postman | Kopieer de bovenstaande OpenAPI-URL en gebruik File > Import > Link in Postman |
| MCP Server | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Tip: Importeer de OpenAPI-specificatie in Postman, Insomnia of een andere API-client om kant-en-klare verzoeksjablonen te krijgen met alle endpoints en schema's.
Snelle start
- Haal uw API-inloggegevens op -- Meld u aan voor een partneraccount en haal uw API-sleutel en geheim op vanuit het dashboard.
- Gebruik de sandbox -- Begin in sandbox-modus om uw integratie te testen met gesimuleerde betalingen en zonder echte kosten.
- Authenticeer verzoeken -- Onderteken elk verzoek met HMAC-SHA256 met de vereiste headers.
- Bekijk producten -- Haal beschikbare vignetten, eSIM-pakketten of verzekeringen op.
- Maak een bestelling aan -- Dien een bestelling in met productselectie, betalingsgegevens en klantinformatie.
- Stel webhooks in -- Registreer webhook-endpoints om realtime meldingen te ontvangen over statuswijzigingen van bestellingen.