Įvadas
Sveiki atvykę į Vignetim partnerių API (Partner API). Ši API leidžia integruoti vinječių pirkimą, eSIM duomenų paketus ir kelionių draudimo produktus tiesiogiai į jūsų platformą.
Bazinis URL
Visos API užklausos siunčiamos adresu:
https://api.vignetim.com/v2/partners
API laikosi RESTful konvencijų ir grąžina JSON atsakymus. Visos užklausos turi būti autentifikuotos naudojant HMAC-SHA256 užklausų pasirašymą.
Ką galite daryti
- Parduoti vinjetes -- Naršykite galimus automagistralių vinječių bilietus Europos šalyse ir kurkite užsakymus savo klientų vardu.
- Parduoti eSIM paketus -- Siūlykite mobiliojo ryšio duomenų paketus keliautojams, apimančius vietines, regionines ir pasaulines kryptis.
- Parduoti kelionių draudimą -- Teikite kelionių draudimo produktus su įvairiomis draudimo apsaugos galimybėmis.
- Valdyti užsakymus -- Sekite užsakymų būseną, filtruokite užsakymų istoriją ir gaukite realaus laiko webhook pranešimus.
Versijų valdymas
Partnerių API versijos nurodomos URL kelyje (/v2/). Nesuderinamų pakeitimų bus tik naujose pagrindinėse versijose. Suderinamų papildymų (nauji laukai, nauji galiniai taškai) gali būti pridėta prie esamos versijos be atskiro pranešimo.
Kūrėjų ištekliai
| Išteklius | Nuoroda |
|---|---|
| OpenAPI specifikacija (JSON) | vignetim.com/api/partner-openapi |
| Swagger UI | api.vignetim.com/docs |
| Importuoti į Postman | Nukopijuokite aukščiau esantį OpenAPI URL ir naudokite File > Import > Link Postman programoje |
| MCP serveris | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Patarimas: Importuokite OpenAPI specifikaciją į Postman, Insomnia ar bet kurį kitą API klientą, kad gautumėte iš anksto paruoštus užklausų šablonus su visais galiniais taškais ir schemomis.
Greitas pradžios vadovas
- Gaukite API kredencialus -- Užsiregistruokite partnerio paskyrai ir gaukite savo API raktą bei slaptažodį iš valdymo skydelio.
- Naudokite sandbox aplinką -- Pradėkite sandbox režimu, kad išbandytumėte integraciją su imituojamais mokėjimais be realių mokesčių.
- Autentifikuokite užklausas -- Pasirašykite kiekvieną užklausą naudodami HMAC-SHA256 su reikalingomis antraštėmis.
- Naršykite produktus -- Gaukite galimų vinječių, eSIM paketų ar draudimo produktų sąrašą.
- Sukurkite užsakymą -- Pateikite užsakymą su produkto pasirinkimu, mokėjimo duomenimis ir kliento informacija.
- Nustatykite webhooks -- Užregistruokite webhook galinius taškus, kad gautumėte realaus laiko pranešimus apie užsakymų būsenos pasikeitimus.