Einführung
Willkommen bei der Vignetim Partner-API. Diese API ermöglicht es Ihnen, Vignettenkäufe, eSIM-Datenpakete und Reiseversicherungsprodukte direkt in Ihre Plattform zu integrieren.
Basis-URL
Alle API-Anfragen werden an folgende Adresse gesendet:
https://api.vignetim.com/v2/partners
Die API folgt RESTful-Konventionen und gibt JSON-Antworten zurück. Alle Anfragen müssen mit HMAC-SHA256-Anfragensignierung authentifiziert werden.
Was Sie tun können
- Vignetten verkaufen -- Durchsuchen Sie verfügbare Autobahnvignetten in europäischen Ländern und erstellen Sie Bestellungen im Namen Ihrer Kunden.
- eSIM-Pakete verkaufen -- Bieten Sie mobile Datenpakete für Reisende an, die lokale, regionale und globale Ziele abdecken.
- Reiseversicherungen verkaufen -- Stellen Sie Reiseversicherungsprodukte mit verschiedenen Deckungsoptionen bereit.
- Bestellungen verwalten -- Verfolgen Sie den Bestellstatus, filtern Sie die Bestellhistorie und empfangen Sie Echtzeit-Webhook-Benachrichtigungen.
Versionierung
Die Partner-API wird über den URL-Pfad (/v2/) versioniert. Breaking Changes (nicht abwärtskompatible Änderungen) werden nur in neuen Hauptversionen eingeführt. Nicht-brechende Ergänzungen (neue Felder, neue Endpunkte) können ohne Vorankündigung zur aktuellen Version hinzugefügt werden.
Entwicklerressourcen
| Ressource | Link |
|---|---|
| OpenAPI-Spezifikation (JSON) | vignetim.com/api/partner-openapi |
| Swagger UI | api.vignetim.com/docs |
| Import in Postman | Kopieren Sie die obige OpenAPI-URL und verwenden Sie Datei > Importieren > Link in Postman |
| MCP-Server | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Tipp: Importieren Sie die OpenAPI-Spezifikation in Postman, Insomnia oder einen beliebigen API-Client, um vorgefertigte Anfragetemplates mit allen Endpunkten und Schemas zu erhalten.
Schnellstart
- API-Zugangsdaten erhalten -- Registrieren Sie sich für ein Partnerkonto und rufen Sie Ihren API-Schlüssel und Ihr Secret im Dashboard ab.
- Sandbox verwenden -- Beginnen Sie im Sandbox-Modus, um Ihre Integration mit simulierten Zahlungen und ohne echte Kosten zu testen.
- Anfragen authentifizieren -- Signieren Sie jede Anfrage mit HMAC-SHA256 und den erforderlichen Headern.
- Produkte durchsuchen -- Rufen Sie verfügbare Vignetten, eSIM-Pakete oder Versicherungsprodukte ab.
- Bestellung erstellen -- Senden Sie eine Bestellung mit Produktauswahl, Zahlungsdetails und Kundeninformationen.
- Webhooks einrichten -- Registrieren Sie Webhook-Endpunkte, um Echtzeit-Benachrichtigungen über Bestellstatusänderungen zu erhalten.