Ú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.

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í

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.