Roamify eSIM API Mudanças Importantes
Donald Bogle
June 9, 2026 22:20
Estamos lançando um conjunto de atualizações de API que trazem novos endpoints, funcionalidade expandida e algumas mudanças das quais você vai querer estar ciente antes de atualizar sua integração.
⚠️ Mudanças Quebradoras — Obter Pacotes eSIM #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. A resposta agora é paginada #
Este endpoint agora retorna resultados paginados em vez de todos os pacotes em uma única resposta. Se sua integração busca pacotes sem parâmetros de paginação, você pode estar recebendo apenas a primeira página de resultados.
Ação necessária: Atualize sua integração para lidar com respostas paginadas usando os parâmetros de consulta page e pageSize.
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
| página | string | 1 | Número da página a ser recuperada. |
| tamanhoDaPágina | string | 50 | Número de resultados por página. |
Para recuperar todos os pacotes, itere pelas páginas até que a resposta retorne menos resultados do que seu tamanhoDaPágina.
2. país e códigoDoPaís agora têm significados distintos #
Anteriormente, esses campos podiam ter sido usados de forma intercambiável. Agora, eles servem a propósitos diferentes e ambos devem usar valores provenientes do GET /api/esim/countries endpoint — strings arbitrárias não são mais aceitas.
| Parâmetro | Valor aceito | Fonte |
|---|---|---|
| país | Nome completo do país | campo name da API de País |
| countryCode | código do país ISO | campo code da API de País |
Ação necessária: Se você estiver atualmente passando strings de país em texto livre, atualize sua integração para primeiro chamar GET /api/esim/countries e use os valores name ou code da resposta.
Novos Endpoints #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Retorna uma lista de todos os países suportados pelo Roamify eSIM. Use os name e code valores desta resposta como entradas de filtro ao consultar GET /api/esim/packages.
parâmetro de filtro opcional disponível com geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Envie uma mensagem SMS diretamente para um eSIM.
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| iccid | string | obrigatório | O ICCID do eSIM para enviar o SMS. |
| mensagem | string | obrigatório | O conteúdo da mensagem a ser enviado. |
Endpoints Atualizados #
POST /api/esim/apply — startDate agora suportado #
Um novo campo opcional startDate foi adicionado ao endpoint Gerar Perfil de eSIM. Para um pequeno subconjunto de pacotes (~30 de 28.000+), este campo é obrigatório.
Você pode identificar esses pacotes verificando se requirements.travelDate é true no objeto do pacote. Se necessário e não fornecido, a solicitação de geração de perfil falhará.
| Nome | Tipo | Necessário | Descrição |
|---|---|---|---|
| dataDeInicio | string | condicional | Data de início da viagem no formato ISO 8601. Necessário se requirements.travelDate for verdadeiro. |
Lembrete de tempo limite
Referência completa da API #
A documentação completa está disponível em docs.getroamify.com.
Se você tiver alguma dúvida ou precisar de ajuda para atualizar sua integração, entre em contato com nossa equipe de suporte ao parceiro.
Planos de destino eSIM relacionados
Perguntas frequentes
- O que aprenderei em Roamify eSIM API Mudanças Importantes?
- Você aprenderá como funciona a ativação do eSIM, como comparar planos de dados e quais etapas de configuração são mais importantes antes e durante sua viagem.
- Como escolho o plano eSIM certo para Japão?
- Combine seu plano com a duração da viagem, uso diário esperado de dados, necessidades de hotspot e qualidade da rede em seu destino. Estadias curtas geralmente precisam de menos dados, enquanto o trabalho remoto e as videochamadas precisam de mais.
- Onde posso comprar planos de viagem eSIM para Japão e Tailândia?
- Use os links de destino neste guia para ir diretamente às páginas dos países do Roamify, comparar opções de planos e concluir a compra antes da partida.