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.