Historial de cambios

Aquí se anota cada cambio de la API pública: el más reciente arriba. La versión que ves en el Swagger (info.version) es la de la última entrada.

Cómo evoluciona la API

• La versión mayor va en la dirección. Todas las llamadas actuales empiezan por /v1. Mientras estés en /v1 solo hacemos cambios compatibles: añadir un endpoint, un campo en una respuesta o un valor nuevo en una lista cerrada de estados.
• Lo que rompe compatibilidad (quitar o renombrar un campo, cambiar su significado, endurecer una validación) va a una versión nueva (/v2) o, si afecta a algo que ya usas, se anuncia antes como obsoleto.
• Plazo de aviso. Una funcionalidad obsoleta sigue funcionando al menos 3 meses desde el aviso. Sus respuestas llevan las cabeceras Deprecation y Sunset con la fecha de retirada.
• Cómo te avisamos. Escribimos al correo de contacto que nos diste al darte las credenciales y lo anotamos aquí.

Consejo

Programa tu integración para ignorar los campos que no conoce y para tolerar valores nuevos en los estados (status): así los cambios compatibles no te afectan.

Tipos de cambio

Tipo	Significado
Añadido	Funcionalidad, endpoint o campo nuevo.
Cambiado	Un comportamiento existente se ajusta.
Obsoleto	Seguirá funcionando hasta su fecha de retirada, pero no deberías usarlo en integraciones nuevas.
Eliminado	Ya no existe.
Corregido	Un error corregido.

Los cambios que rompen compatibilidad se marcan con ⚠️ Rompe compatibilidad.

1.0.0 — Primera versión

29 de octubre de 2026

Añadido

• GET /v1/countries: los países a los que puedes vender.
• GET /v1/availability: el plan eSIM más barato para uno o varios países, una fecha de inicio y una duración, con el precio de una eSIM (pricePerDay, totalPrice) y un token que recuerda la búsqueda.
• POST /v1/prebooking: reserva las eSIM de un plan (el token y el cardsNumber, de 1 a 100) y devuelve el prebookingId y el importe (pricePerCard, totalPrice).
• POST /v1/booking: confirma la venta con los datos del titular y devuelve el locator, la voucherUrl y el importe. Se puede repetir sin duplicar la venta.
• GET /v1/sales/{locator}: el detalle de una venta tuya: estado de la venta y de cada eSIM, titular, desglose del importe y voucherUrl.
• Autenticación HTTP Basic, entornos PRE y PRO y errores uniformes (application/problem+json).