Úvod
Vítejte v Vignetim Partner API. Toto API vám umožňuje integrovat nákup dálničních známek (vignettes), eSIM datových balíčků a produktů cestovního pojištění přímo do vaší platformy.
Základní URL (Base URL)
Všechny API požadavky se odesílají na:
https://api.vignetim.com/v2/partners
API se řídí konvencemi RESTful a vrací odpovědi ve formátu JSON. Všechny požadavky musí být ověřeny pomocí podepisování požadavků HMAC-SHA256.
Co můžete dělat
- Prodávat dálniční známky -- Procházejte dostupné dálniční známky napříč evropskými zeměmi a vytvářejte objednávky jménem svých zákazníků.
- Prodávat eSIM balíčky -- Nabízejte mobilní datové balíčky pro cestovatele pokrývající místní, regionální a globální destinace.
- Prodávat cestovní pojištění -- Poskytujte produkty cestovního pojištění s různými možnostmi krytí.
- Spravovat objednávky -- Sledujte stav objednávek, filtrujte historii objednávek a přijímejte oznámení přes webhooky v reálném čase.
Verzování
Partner API je verzováno prostřednictvím cesty URL (/v2/). Zpětně nekompatibilní změny (breaking changes) budou zavedeny pouze v nových hlavních verzích. Zpětně kompatibilní doplnění (nová pole, nové endpointy) mohou být přidána do aktuální verze bez předchozího upozornění.
Vývojářské zdroje
| Zdroj | Odkaz |
|---|---|
| OpenAPI specifikace (JSON) | vignetim.com/api/partner-openapi |
| Swagger UI | api.vignetim.com/docs |
| Import do Postman | Zkopírujte výše uvedenou OpenAPI URL a použijte File > Import > Link v Postmanu |
| MCP Server | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Tip: Importujte OpenAPI specifikaci do Postmanu, Insomnia nebo jakéhokoli API klienta a získáte předpřipravené šablony požadavků se všemi endpointy a schématy.
Rychlý start
- Získejte své API přihlašovací údaje -- Zaregistrujte si partnerský účet a získejte svůj API klíč a tajný klíč z řídicího panelu.
- Použijte sandbox -- Začněte v režimu sandbox a otestujte svou integraci se simulovanými platbami bez skutečných poplatků.
- Ověřujte požadavky -- Podepisujte každý požadavek pomocí HMAC-SHA256 s požadovanými hlavičkami.
- Procházejte produkty -- Načtěte dostupné dálniční známky, eSIM balíčky nebo pojistné produkty.
- Vytvořte objednávku -- Odešlete objednávku s výběrem produktu, platebními údaji a informacemi o zákazníkovi.
- Nastavte webhooky -- Zaregistrujte webhookové endpointy pro příjem oznámení o změnách stavu objednávek v reálném čase.