Bevezetés
Üdvözöljük a Vignetim Partner API-ban. Ez az API lehetővé teszi, hogy matricavásárlásokat, eSIM adatcsomagokat és utasbiztosítási termékeket közvetlenül integrálja a platformjába.
Alap URL (Base URL)
Minden API-kérés a következő címre történik:
https://api.vignetim.com/v2/partners
Az API a RESTful konvenciókat követi, és JSON-válaszokat ad vissza. Minden kérést HMAC-SHA256 kéréshitelesítéssel kell aláírni.
Mit tehet
- Matricák értékesítése -- Böngésszen az elérhető autópálya-matricajegyek között az európai országokban, és hozzon létre megrendeléseket ügyfelei nevében.
- eSIM csomagok értékesítése -- Kínáljon mobil adatcsomagokat utazóknak helyi, regionális és globális célállomásokra.
- Utasbiztosítás értékesítése -- Biztosítson utasbiztosítási termékeket különböző fedezeti lehetőségekkel.
- Megrendelések kezelése -- Kövesse nyomon a megrendelési állapotot, szűrje a rendelési előzményeket, és kapjon valós idejű webhook-értesítéseket.
Verziókezelés (Versioning)
A Partner API verziószáma az URL elérési útján keresztül van meghatározva (/v2/). Visszafelé nem kompatibilis változások csak új főverzióban kerülnek bevezetésre. Nem megszakító jellegű kiegészítések (új mezők, új végpontok) előzetes értesítés nélkül hozzáadhatók az aktuális verzióhoz.
Fejlesztői erőforrások
| Erőforrás | Hivatkozás |
|---|---|
| OpenAPI specifikáció (JSON) | vignetim.com/api/partner-openapi |
| Swagger UI | api.vignetim.com/docs |
| Importálás Postman-be | Másolja ki a fenti OpenAPI URL-t, és használja a File > Import > Link opciót a Postman-ben |
| MCP szerver | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Tipp: Importálja az OpenAPI specifikációt a Postman, Insomnia vagy bármely API-kliens alkalmazásba, hogy előre elkészített kéréssablonokat kapjon az összes végponttal és sémával.
Gyors indítás (Quick Start)
- Szerezze be API hitelesítő adatait -- Regisztráljon partner fiókot, és kérje le API-kulcsát és titkos kulcsát a vezérlőpultról.
- Használja a sandboxot -- Kezdje sandbox módban az integráció teszteléséhez szimulált fizetésekkel és valós terhelés nélkül.
- Hitelesítse a kéréseket -- Minden kérést írjon alá HMAC-SHA256 használatával a szükséges fejlécekkel.
- Böngéssze a termékeket -- Kérje le az elérhető matricákat, eSIM csomagokat vagy biztosítási termékeket.
- Hozzon létre megrendelést -- Küldjön be egy megrendelést a termékválasztással, fizetési adatokkal és ügyfélinformációkkal.
- Állítson be webhookokat -- Regisztráljon webhook végpontokat, hogy valós idejű értesítéseket kapjon a megrendelési állapotváltozásokról.