Roamify eSIM API Cambios Importantes
Donald Bogle
June 9, 2026 22:20
Estamos implementando un conjunto de actualizaciones de API que traen nuevos endpoints, funcionalidad ampliada y algunos cambios de los que querrás estar al tanto antes de actualizar tu integración.
⚠️ Cambios importantes — Obtener paquetes de eSIM #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. La respuesta ahora está paginada #
Este endpoint ahora devuelve resultados paginados en lugar de todos los paquetes en una sola respuesta. Si tu integración obtiene paquetes sin parámetros de paginación, es posible que solo estés recibiendo la primera página de resultados.
Acción requerida: Actualiza tu integración para manejar respuestas paginadas utilizando los parámetros de consulta page y pageSize.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| página | cadena | 1 | Número de página a recuperar. |
| tamañoDePágina | cadena | 50 | Número de resultados por página. |
Para recuperar todos los paquetes, itere a través de las páginas hasta que la respuesta devuelva menos resultados que su tamañoDePágina.
2. país y códigoDePaís ahora tienen significados distintos #
Anteriormente, estos campos podían haberse utilizado de manera intercambiable. Ahora sirven para diferentes propósitos y ambos deben usar valores obtenidos de la GET /api/esim/countries endpoint — las cadenas arbitrarias ya no son aceptadas.
| Parámetro | Valor aceptado | Fuente |
|---|---|---|
| país | Nombre completo del país | campo name de la API de País |
| código de país | código ISO del país | campo code de la API de País |
Acción requerida: Si actualmente estás pasando cadenas de país en texto libre, actualiza tu integración para primero llamar a GET /api/esim/countries y usar los valores de name o code de la respuesta.
Nuevos Puntos Finales #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Devuelve una lista de todos los países soportados por Roamify eSIM. Usa los name y code valores de esta respuesta como entradas de filtro al consultar GET /api/esim/packages.
parámetro de filtro opcional disponible con geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Envía un mensaje SMS directamente a un eSIM.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| iccid | cadena | requerido | El ICCID de la eSIM a la que enviar el SMS. |
| mensaje | cadena | requerido | El contenido del mensaje a enviar. |
Puntos finales actualizados #
POST /api/esim/apply — fechaInicio ahora soportado #
Se ha añadido un nuevo campo opcional fechaInicio al punto final de Generar perfil de eSIM. Para un pequeño subconjunto de paquetes (~30 de 28,000+), este campo es requerido.
Puedes identificar estos paquetes verificando si requirements.travelDate es verdadero en el objeto del paquete. Si es necesario y no se proporciona, la solicitud de generación de perfil fallará.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| fechaInicio | cadena | condicional | Fecha de inicio del viaje en formato ISO 8601. Requerido si requirements.travelDate es verdadero. |
Recordatorio de tiempo de espera
Referencia completa de la API #
La documentación completa está disponible en docs.getroamify.com.
Si tienes alguna pregunta o necesitas ayuda para actualizar tu integración, contacta a nuestro equipo de soporte para socios.
Planes de destino eSIM relacionados
Preguntas frecuentes
- ¿Qué aprenderé en Roamify eSIM API Cambios Importantes?
- Aprenderá cómo funciona la activación de eSIM, cómo comparar planes de datos y qué pasos de configuración son más importantes antes y durante su viaje.
- ¿Cómo elijo el plan eSIM correcto para Japón?
- Haga coincidir su plan con la duración del viaje, el uso diario esperado de datos, las necesidades de puntos de acceso y la calidad de la red en su destino. Las estancias cortas suelen necesitar menos datos, mientras que el trabajo remoto y las videollamadas necesitan más.
- ¿Dónde puedo comprar planes eSIM de viaje para Japón y Tailandia?
- Utilice los enlaces de destino en esta guía para ir directamente a las páginas de países de Roamify, comparar opciones de planes y completar el pago antes de la salida.