Um guia API-first para códigos de verificação suecos +46

Quais endpoints chamo para receber um OTP por SMS sueco?

Comece com uma chave de API do Developer console. As chaves têm o prefixo or_live_ e vão em um cabeçalho Bearer contra https://otproute.com/api/v1; você pode ter até 10 delas, o que facilita separar o CI, o staging e o laptop de um desenvolvedor. O id de país da Suécia é se.

1. GET /api/v1/services e GET /api/v1/countries fornecem os ids. Faça cache deles a cada execução.
2. GET /api/v1/prices?country=se&service=discord retorna o preço e a disponibilidade de hoje para esse par.
3. POST /api/v1/activations com {"service": "discord", "country": "se"} cria o pedido e retorna um id de ativação mais um número +46.
4. O seu teste digita o número na tela de verificação do produto.
5. O código chega a você por um webhook ou por GET /api/v1/activations/{id}.
6. POST /api/v1/activations/{id}/cancel libera um pedido de que o teste não precisa mais.

Uma chamada a GET /api/v1/balance antes da suíte permite que o job pare mais cedo quando a carteira estiver baixa. O teto é de 300 requisições por minuto, de sobra para um intervalo de polling de alguns segundos. Veja o guia de integração da API de OTP para um passo a passo mais completo desta API de verificação por SMS.

Como verifico o webhook antes de confiar em um código +46?

Registre um endpoint no Developer console (até 5 por conta) e assine activation.sms_received, activation.expired e activation.cancelled.

Toda entrega inclui X-OTPRoute-Signature: t=<unix>,v1=<hex>. O seu handler deve:

• reconstruir a string "<t>.<raw body>" a partir do corpo da requisição intocado;
• calcular o HMAC-SHA256 com o segredo daquele endpoint e comparar com o v1 em tempo constante;
• rejeitar timestamps fora de uma tolerância curta para bloquear replays;
• usar o id da ativação como chave do seu trabalho, para que uma entrega repetida não processe o mesmo código duas vezes.

O polling continua sendo uma alternativa válida quando um firewall bloqueia chamadas de entrada. O post sobre segurança de webhooks com HMAC cobre os casos extremos.

Que serviços um número +46 consegue verificar?

A rota sueca lista atualmente mais de 1.700 serviços. Entre os exemplos atuais estão WhatsApp, Telegram, Discord, Snapchat, LinkedIn, Microsoft e Outlook, Google (Gmail e YouTube), Uber, Netflix, Amazon, Signal, ChatGPT (OpenAI), Claude, eBay e X (Twitter).

As contagens e a disponibilidade mudam ao longo do dia, então deixe o endpoint de preços decidir o que os seus testes pedem, em vez de fixar uma lista no código.

Como normalizar e interpretar números suecos?

A Suécia usa o prefixo de tronco 0. Um celular escrito localmente como 07 seguido de mais oito dígitos vira +46 7 e esses oito dígitos em E.164, com o zero removido. Armazene essa forma internacional e garanta que o tratamento da entrada remova espaços, hifens e o zero inicial antes de acrescentar +46. Um número +46 para testes é uma boa fixture justamente para essa verificação, porque os suecos costumam digitar a forma local por hábito.

Os templates de SMS em sueco podem incluir as letras å, ä e ö. Se o seu pipeline registra a mensagem bruta em log, confirme que ele trata texto Unicode sem problemas e extraia o código por um padrão de dígitos, e não por uma frase em inglês como "your code is". Assim o mesmo parser funciona quer o serviço escreva em sueco ou em inglês.

As equipes testam aqui para lançamentos nos países nórdicos, para revisar os textos em sueco do onboarding e para equipes regionais de suporte que operam contas em nome da empresa.

Quem não é desenvolvedor pode usar o painel para a Suécia?

Sim. Selecione a Suécia e um serviço, confira o preço em tempo real e confirme. O número +46 aparece na lista de pedidos; cole-o no app, e o código surge ao lado quando o serviço o enviar. Gerentes de produto e equipes de suporte usam esse caminho para verificar um único fluxo com um número de verificação da Suécia sem tocar na API. A criação da conta exige um e-mail e um código de 6 dígitos em cadastro.

Por que um código +46 pode não chegar e o que fazer?

Cada ativação fica aberta por 20 minutos, e você só paga se o código chegar. Pedidos expirados ou cancelados devolvem o valor integral à carteira, sem necessidade de chamado.

Se um código estiver faltando, dê tempo à janela e depois tente de novo mais tarde ou teste pela rota de outro serviço. Alguns serviços recusam números virtuais, e uma recusa na tela de cadastro costuma significar isso, e não uma falha de entrega. Espaçe as tentativas em vez de refazer o pedido em um laço apertado; uma boa lógica de roteamento de OTP trata um código ausente como sinal para esperar ou trocar, e não para martelar.

Linhas dedicadas, carteira e sandbox para testes na Suécia

Um número de longo prazo em autoatendimento na Suécia não faz parte da OTP Route hoje. Os Números Dedicados estão disponíveis apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês; para uma linha sueca duradoura, escreva para [email protected], e a equipe dirá se as regras locais permitem.

O financiamento funciona por uma carteira pré-paga em USD sem mensalidade, recarregada por cartão ou USDT/USDC, e cada recarga é seguida de uma fatura em PDF. Peça para mudar uma conta de desenvolvimento para sandbox se quiser números e códigos simulados para o CI. Os detalhes de custo estão na página de preços.

Teste apenas os seus próprios produtos, respeite os termos de cada serviço e siga a Política de Uso Aceitável da OTP Route.

Perguntas frequentes

Qual é o id de país da Suécia na API da OTP Route?

É se, usado na query string de preços e no corpo da ativação.

Armazeno os números suecos com o 0 na frente?

Não. Remova o zero do tronco e salve a forma E.164 começando com +46; mostre a forma local apenas se a sua interface precisar.

Posso testar o fluxo de cadastro sueco do meu app sem um chip sueco?

Sim. Peça um número +46 para o serviço, digite-o no seu app e receba o código por webhook, polling ou pelo painel.

Os caracteres suecos vão quebrar o meu parser de OTP?

Não deveriam, se você buscar dígitos em vez de palavras e tratar a mensagem como texto Unicode.

Quanto custa um pedido +46 que falhou?

Nada. Sem um SMS em 20 minutos, ou depois de um cancelamento, todo o valor volta para a carteira.

Posso ter um número sueco que fique só meu?

Não como produto de autoatendimento. Números de longo prazo são oferecidos nos EUA e no Canadá; escreva para [email protected] para perguntar sobre a Suécia.

Como rodo testes de integração sem usar fundos reais?

Peça o modo sandbox para uma conta de desenvolvimento, que retorna números e códigos simulados de ponta a ponta.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.