Introducere
Bine ați venit la API-ul Vignetim pentru Parteneri (Partner API). Acest API vă permite să integrați achiziții de vignete, pachete de date eSIM și produse de asigurare de călătorie direct în platforma dumneavoastră.
Adresa de bază (Base URL)
Toate cererile API se fac către:
https://api.vignetim.com/v2/partners
API-ul respectă convențiile RESTful și returnează răspunsuri JSON. Toate cererile trebuie autentificate utilizând semnarea cererilor HMAC-SHA256.
Ce puteți face
- Vânzare vignete -- Răsfoiți vignetele de autostradă disponibile din țările europene și creați comenzi în numele clienților dumneavoastră.
- Vânzare pachete eSIM -- Oferiți pachete de date mobile pentru călători, acoperind destinații locale, regionale și globale.
- Vânzare asigurări de călătorie -- Furnizați produse de asigurare de călătorie cu diverse opțiuni de acoperire.
- Gestionare comenzi -- Urmăriți starea comenzilor, filtrați istoricul comenzilor și primiți notificări webhook (webhook) în timp real.
Versionare
API-ul pentru Parteneri este versionat prin calea URL-ului (/v2/). Modificările incompatibile vor fi introduse doar în versiuni majore noi. Adăugiri compatibile (câmpuri noi, endpoint-uri noi) pot fi adăugate la versiunea curentă fără notificare prealabilă.
Resurse pentru dezvoltatori
| Resursă | Link |
|---|---|
| Specificație OpenAPI (JSON) | vignetim.com/api/partner-openapi |
| Swagger UI | api.vignetim.com/docs |
| Import în Postman | Copiați URL-ul OpenAPI de mai sus și utilizați File > Import > Link în Postman |
| Server MCP | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Sfat: Importați specificația OpenAPI în Postman, Insomnia sau orice client API pentru a obține șabloane de cereri pre-construite cu toate endpoint-urile și schemele gata de utilizare.
Start rapid
- Obțineți credențialele API -- Înregistrați-vă pentru un cont de partener și preluați cheia API și secretul din panoul de control.
- Utilizați sandbox-ul -- Începeți în modul sandbox pentru a testa integrarea cu plăți simulate și fără taxe reale.
- Autentificați cererile -- Semnați fiecare cerere utilizând HMAC-SHA256 cu anteturile necesare.
- Răsfoiți produsele -- Preluați vignetele disponibile, pachetele eSIM sau produsele de asigurare.
- Creați o comandă -- Trimiteți o comandă cu selecția produsului, detaliile de plată și informațiile clientului.
- Configurați webhook-urile -- Înregistrați endpoint-uri webhook pentru a primi notificări în timp real despre modificările stării comenzilor.