Wprowadzenie

Witamy w API Partnerskim Vignetim (Vignetim Partner API). To API umozliwia integracjie zakupow winiet, pakietow danych eSIM oraz produktow ubezpieczenia podroznego bezposrednio w Twojej platformie.

Bazowy URL

Wszystkie zapytania API sa wysylane pod adres:

https://api.vignetim.com/v2/partners

API stosuje konwencje RESTful i zwraca odpowiedzi w formacie JSON. Wszystkie zapytania musza byc uwierzytelnione za pomoca podpisywania zadan HMAC-SHA256.

Co mozesz zrobic

Sprzedawaj winiety -- Przegladaj dostepne winiety autostradowe w krajach europejskich i tworzz zamowienia w imieniu swoich klientow.
Sprzedawaj pakiety eSIM -- Oferuj mobilne pakiety danych dla podroznych, obejmujace lokalne, regionalne i globalne destynacje.
Sprzedawaj ubezpieczenia podrozne -- Udostepniaj produkty ubezpieczenia podroznego z roznymi opcjami ochrony.
Zarzadzaj zamowieniami -- Sledz status zamowien, filtruj historie zamowien i otrzymuj powiadomienia webhook w czasie rzeczywistym.

Wersjonowanie

API Partnerskie jest wersjonowane za pomoca sciezki URL (/v2/). Zmiany niekompatybilne wstecz (breaking changes) beda wprowadzane tylko w nowych glownych wersjach. Nieprzerywajace dodatki (nowe pola, nowe endpointy) moga byc dodawane do biezacej wersji bez uprzedzenia.

Zasoby dla deweloperow

Zasob	Link
Specyfikacja OpenAPI (JSON)	vignetim.com/api/partner-openapi
Swagger UI	api.vignetim.com/docs
Import do Postmana	Skopiuj powyzszy URL OpenAPI i uzyj File > Import > Link w Postmanie
Serwer MCP	`claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp`

Wskazowka: Zaimportuj specyfikacje OpenAPI do Postmana, Insomnia lub dowolnego klienta API, aby uzyskac gotowe szablony zapytan ze wszystkimi endpointami i schematami.

Szybki start

Uzyskaj dane uwierzytelniajace API -- Zarejestruj konto partnerskie i pobierz swoj klucz API oraz sekret z panelu partnerskiego.
Uzyj srodowiska sandbox -- Rozpocznij w trybie sandbox (piaskownica), aby przetestowac integracje z symulowanymi platnoscia i bez rzeczywistych oplat.
Uwierzytelniaj zapytania -- Podpisuj kazde zapytanie za pomoca HMAC-SHA256 z wymaganymi naglowkami.
Przegladaj produkty -- Pobierz dostepne winiety, pakiety eSIM lub produkty ubezpieczeniowe.
Utworz zamowienie -- Wyslij zamowienie z wyborem produktu, danymi platnosci i informacjami o kliencie.
Skonfiguruj webhooki -- Zarejestruj endpointy webhook, aby otrzymywac powiadomienia w czasie rzeczywistym o zmianach statusu zamowien.

Co mozesz zrobic

Sprzedawaj winiety -- Przegladaj dostepne winiety autostradowe w krajach europejskich i tworzz zamowienia w imieniu swoich klientow.

Sprzedawaj pakiety eSIM -- Oferuj mobilne pakiety danych dla podroznych, obejmujace lokalne, regionalne i globalne destynacje.

Sprzedawaj ubezpieczenia podrozne -- Udostepniaj produkty ubezpieczenia podroznego z roznymi opcjami ochrony.

Zarzadzaj zamowieniami -- Sledz status zamowien, filtruj historie zamowien i otrzymuj powiadomienia webhook w czasie rzeczywistym.

Zasoby dla deweloperow

Zasob	Link
Specyfikacja OpenAPI (JSON)	vignetim.com/api/partner-openapi
Swagger UI	api.vignetim.com/docs
Import do Postmana	Skopiuj powyzszy URL OpenAPI i uzyj File > Import > Link w Postmanie
Serwer MCP	`claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp`

Wskazowka: Zaimportuj specyfikacje OpenAPI do Postmana, Insomnia lub dowolnego klienta API, aby uzyskac gotowe szablony zapytan ze wszystkimi endpointami i schematami.

Szybki start

Uzyskaj dane uwierzytelniajace API -- Zarejestruj konto partnerskie i pobierz swoj klucz API oraz sekret z panelu partnerskiego.

Uzyj srodowiska sandbox -- Rozpocznij w trybie sandbox (piaskownica), aby przetestowac integracje z symulowanymi platnoscia i bez rzeczywistych oplat.

Uwierzytelniaj zapytania -- Podpisuj kazde zapytanie za pomoca HMAC-SHA256 z wymaganymi naglowkami.

Przegladaj produkty -- Pobierz dostepne winiety, pakiety eSIM lub produkty ubezpieczeniowe.

Utworz zamowienie -- Wyslij zamowienie z wyborem produktu, danymi platnosci i informacjami o kliencie.

Skonfiguruj webhooki -- Zarejestruj endpointy webhook, aby otrzymywac powiadomienia w czasie rzeczywistym o zmianach statusu zamowien.