Uvod
Dobrodošli v Vignetim Partner API. Ta API vam omogoča integracijo nakupov vinjet, eSIM podatkovnih paketov in produktov potovalnega zavarovanja neposredno v vašo platformo.
Osnovni URL
Vse API zahteve se pošiljajo na:
https://api.vignetim.com/v2/partners
API sledi RESTful konvencijam in vrača JSON odgovore. Vse zahteve morajo biti avtenticirane z uporabo HMAC-SHA256 podpisovanja zahtev.
Kaj lahko počnete
- Prodajajte vinjete -- Pregledujte razpoložljive avtocestne vinjete po evropskih državah in ustvarjajte naročila v imenu svojih strank.
- Prodajajte eSIM pakete -- Ponudite mobilne podatkovne pakete za popotnike, ki pokrivajo lokalne, regionalne in globalne destinacije.
- Prodajajte potovalno zavarovanje -- Zagotovite produkte potovalnega zavarovanja z različnimi možnostmi kritja.
- Upravljajte naročila -- Spremljajte status naročil, filtrirajte zgodovino naročil in prejemajte obvestila v realnem času prek webhookov.
Verzioniranje
Partner API je verzioniran prek URL poti (/v2/). Spremembe, ki prekinejo združljivost (breaking changes), bodo uvedene samo v novih glavnih verzijah. Neprekinjajoče dodatke (nova polja, nove končne točke) se lahko dodaja v trenutno verzijo brez predhodnega obvestila.
Viri za razvijalce
| Vir | Povezava |
|---|---|
| OpenAPI specifikacija (JSON) | vignetim.com/api/partner-openapi |
| Swagger UI | api.vignetim.com/docs |
| Uvoz v Postman | Kopirajte zgornjo OpenAPI povezavo in uporabite File > Import > Link v Postmanu |
| MCP strežnik | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Namig: Uvozite OpenAPI specifikacijo v Postman, Insomnia ali katerega koli API odjemalca, da dobite vnaprej pripravljene predloge zahtev z vsemi končnimi točkami in shemami.
Hiter začetek
- Pridobite API poverilnice -- Registrirajte se za partnerski račun in pridobite svoj API ključ in skrivnost na nadzorni plošči.
- Uporabite peskovnik (sandbox) -- Začnite v načinu peskovnika za testiranje vaše integracije s simuliranimi plačili in brez resničnih stroškov.
- Avtenticirajte zahteve -- Podpišite vsako zahtevo z HMAC-SHA256 z zahtevanimi glavlji.
- Pregledujte produkte -- Pridobite razpoložljive vinjete, eSIM pakete ali zavarovalne produkte.
- Ustvarite naročilo -- Oddajte naročilo z izbiro produktov, podrobnostmi plačila in podatki o stranki.
- Nastavite webhooke -- Registrirajte webhook končne točke za prejemanje obvestil o spremembah statusa naročil v realnem času.