Въведение
Добре дошли в партньорския API (Partner API) на Vignetim. Този API ви позволява да интегрирате покупки на винетки, eSIM пакети за данни и застрахователни продукти за пътуване директно във вашата платформа.
Базов URL адрес
Всички API заявки се изпращат към:
https://api.vignetim.com/v2/partners
API-то следва RESTful конвенции и връща отговори в JSON формат. Всички заявки трябва да бъдат удостоверени чрез HMAC-SHA256 подписване на заявки.
Какво можете да правите
- Продажба на винетки -- Разглеждайте наличните винетки за магистрали в европейски държави и създавайте поръчки от името на вашите клиенти.
- Продажба на eSIM пакети -- Предлагайте мобилни пакети за данни за пътуващи, обхващащи локални, регионални и глобални дестинации.
- Продажба на застраховки за пътуване -- Предоставяйте застрахователни продукти за пътуване с различни опции за покритие.
- Управление на поръчки -- Проследявайте статуса на поръчките, филтрирайте историята на поръчките и получавайте известия в реално време чрез webhook-ове.
Версиониране
Партньорският API е версиониран чрез пътя на URL адреса (/v2/). Промени, нарушаващи съвместимостта (breaking changes), ще бъдат въведени само в нови основни версии. Допълнения, които не нарушават съвместимостта (нови полета, нови крайни точки), могат да бъдат добавени към текущата версия без предварително уведомление.
Ресурси за разработчици
| Ресурс | Връзка |
|---|---|
| OpenAPI спецификация (JSON) | vignetim.com/api/partner-openapi |
| Swagger UI | api.vignetim.com/docs |
| Импортиране в Postman | Копирайте горния OpenAPI URL адрес и използвайте File > Import > Link в Postman |
| MCP сървър | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Съвет: Импортирайте OpenAPI спецификацията в Postman, Insomnia или друг API клиент, за да получите готови шаблони за заявки с всички крайни точки и схеми.
Бързо начало
- Получете вашите API идентификационни данни -- Регистрирайте се за партньорски акаунт и вземете вашия API ключ и тайна от таблото за управление.
- Използвайте sandbox среда -- Започнете в sandbox режим, за да тествате вашата интеграция със симулирани плащания и без реални такси.
- Удостоверявайте заявки -- Подписвайте всяка заявка чрез HMAC-SHA256 с необходимите хедъри.
- Разглеждайте продукти -- Извличайте наличните винетки, eSIM пакети или застрахователни продукти.
- Създайте поръчка -- Подайте поръчка с избор на продукт, данни за плащане и информация за клиента.
- Настройте webhook-ове -- Регистрирайте webhook крайни точки, за да получавате известия в реално време за промени в статуса на поръчките.