Introducción
Bienvenido a la API de Socios (Partner API) de Vignetim. Esta API le permite integrar la compra de viñetas, paquetes de datos eSIM y productos de seguro de viaje directamente en su plataforma.
URL base
Todas las solicitudes a la API se realizan a:
https://api.vignetim.com/v2/partners
La API sigue las convenciones RESTful y devuelve respuestas en formato JSON. Todas las solicitudes deben autenticarse mediante firma de solicitud HMAC-SHA256.
Qué puede hacer
- Vender viñetas -- Explore los tickets de viñeta de autopista disponibles en países europeos y cree pedidos en nombre de sus clientes.
- Vender paquetes eSIM -- Ofrezca paquetes de datos móviles para viajeros, cubriendo destinos locales, regionales y globales.
- Vender seguros de viaje -- Proporcione productos de seguro de viaje con diversas opciones de cobertura.
- Gestionar pedidos -- Realice seguimiento del estado de los pedidos, filtre el historial de pedidos y reciba notificaciones en tiempo real mediante webhooks.
Versionado
La API de Socios se versiona a través de la ruta URL (/v2/). Los cambios incompatibles solo se introducirán en nuevas versiones principales. Las adiciones no incompatibles (nuevos campos, nuevos endpoints) pueden agregarse a la versión actual sin previo aviso.
Recursos para desarrolladores
| Recurso | Enlace |
|---|---|
| Especificación OpenAPI (JSON) | vignetim.com/api/partner-openapi |
| Swagger UI | api.vignetim.com/docs |
| Importar a Postman | Copie la URL de OpenAPI anterior y use File > Import > Link en Postman |
| Servidor MCP | claude mcp add vignetim-api-docs --transport http https://vignetim.com/api/mcp |
Consejo: Importe la especificación OpenAPI en Postman, Insomnia o cualquier cliente API para obtener plantillas de solicitud predefinidas con todos los endpoints y esquemas listos para usar.
Inicio rápido
- Obtenga sus credenciales de API -- Regístrese para una cuenta de socio y obtenga su clave API y secreto desde el panel de control.
- Use el sandbox -- Comience en modo sandbox (entorno de pruebas) para probar su integración con pagos simulados y sin cargos reales.
- Autentique las solicitudes -- Firme cada solicitud usando HMAC-SHA256 con los encabezados requeridos.
- Explore los productos -- Obtenga las viñetas, paquetes eSIM o productos de seguro disponibles.
- Cree un pedido -- Envíe un pedido con la selección de productos, datos de pago e información del cliente.
- Configure webhooks -- Registre endpoints de webhook para recibir notificaciones en tiempo real sobre cambios en el estado de los pedidos.