Integrando a verificação +993 do Turcomenistão ao seu pipeline de OTP

Quais chamadas de API retornam um número de verificação do Turcomenistão?

Comece pelos endpoints, já que eles definem todo o resto. Autentique-se em https://otproute.com/api/v1 com uma chave Bearer do console do desenvolvedor; as chaves têm o prefixo or_live_ e cada conta pode ter até 10. O id de país do Turcomenistão é tm.

1. GET /api/v1/services e GET /api/v1/countries fornecem o catálogo. Faça cache, mas atualize todo dia.
2. GET /api/v1/prices?country=tm&service=<id> informa o preço atual e se a rota está aberta para aquele serviço.
3. POST /api/v1/activations com {"service": "imo", "country": "tm"} reserva um número +993 e retorna um id de ativação.
4. GET /api/v1/activations/{id} retorna o estado do pedido +993 e, depois que o SMS chega, também o código.
5. POST /api/v1/activations/{id}/cancel libera um pedido de que o seu teste não precisa mais.
6. GET /api/v1/balance permite que um pipeline pare cedo quando o saldo estiver baixo.

O limite da conta é de 300 requisições por minuto, compartilhado por todas as chaves. A referência da API documenta o formato das requisições e respostas.

Um teste com +993 deve escutar webhooks ou fazer polling?

O polling serve bem para um único desenvolvedor clicando por um fluxo. Quando vários jobs rodam ao mesmo tempo, os webhooks saem mais baratos e reagem mais rápido. Uma conta pode ter 5 endpoints de webhook; aponte um deles para o seu executor de testes do Turcomenistão para activation.sms_received, activation.expired e activation.cancelled.

Trate toda entrega como não confiável até que se prove o contrário. Separe o cabeçalho X-OTPRoute-Signature em t e v1, calcule o HMAC-SHA256 sobre t, um ponto e o corpo bruto exato com o segredo do seu endpoint, e compare em tempo constante. Rejeite timestamps fora de uma tolerância curta para bloquear replays. Guarde os resultados com o id da ativação como chave, para que uma entrega repetida não mude nada. Nosso artigo sobre captura de OTP por webhook mostra um handler com fila, e os testes em pipelines de CI tratam de timeouts em jobs de build.

O que dá para verificar com um número de verificação do Turcomenistão?

A rota tm lista mais de 1.600 serviços. Entre os mais pedidos no momento estão imo, Telegram, WhatsApp, Google (Gmail & YouTube), Instagram, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI), Viber, WeChat, Discord e Snapchat. Os apps de mensagens concentram boa parte do tráfego do dia a dia na Ásia Central, e por isso aparecem tanto.

Isto é um retrato do momento, não um contrato. A capacidade das operadoras parceiras muda ao longo do dia, então consulte os preços antes de cada execução em vez de supor que a lista de ontem continua valendo.

Como os números +993 são formatados e localizados?

O número nacional significativo do Turcomenistão tem oito dígitos, e a maioria das faixas de celular começa com 6. Em discagem doméstica, usa-se o prefixo de tronco 8 na frente; no formato internacional esse prefixo cai e o número vira +993 seguido dos oito dígitos.

• Normalize para E.164 (+9936XXXXXXX) na borda do seu sistema e armazene apenas essa forma.
• Não reaproveite validações escritas para países vizinhos; tamanhos e prefixos variam pela Ásia Central.
• O turcomeno é o idioma oficial e é escrito num alfabeto latino com letras como ä, ç, ň, ö, ş, ü, ý e ž. O russo ainda é amplamente compreendido. Um SMS de verificação pode, portanto, chegar em turcomeno, russo ou inglês, e o seu extrator deve ler dígitos de qualquer corpo em UTF-8.

As equipes costumam testar aqui quando há um lançamento planejado na Ásia Central, quando uma interface em turcomeno ou russo precisa de QA de localização ou quando atendem clientes que viajam entre Asgabate e os mercados vizinhos.

Dá para pedir um código +993 sem escrever código?

Sim. Depois de criar a conta com um código por e-mail ou com o Google e de colocar saldo na carteira, abra o OTP Gateway, escolha um serviço, selecione o Turcomenistão e confirme o preço exibido. O número +993 aparece imediatamente; digite-o onde o app pedir, solicite o SMS e acompanhe o cartão da ativação para ver o código. O número serve apenas para aquela verificação.

Por que um código do Turcomenistão pode não chegar?

• O serviço recusa números virtuais. Alguns recusam. É uma política do lado deles, e a regra de reembolso existe justamente para esse caso.
• A rota está ocupada. Tente de novo mais tarde ou com uma nova ativação, que usa um número diferente.
• A janela foi interrompida. Deixe a ativação aberta pelos 20 minutos completos; um pedido expirado é reembolsado automaticamente.
• O loop de tentativas é agressivo demais. Aumente o intervalo entre as tentativas em vez de fazer pedidos em sequência.

Essas medidas mantêm o roteamento de OTP saudável para todos que compartilham o pool.

Existe uma linha turcomena de longo prazo, e como funciona a cobrança?

Não existe Número Dedicado em autoatendimento para o Turcomenistão. A OTP Route vende linhas de longo prazo apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês; pedidos para outros países podem ser enviados para [email protected], sem promessa de que as regras locais permitam.

Todo o resto funciona a partir de uma única carteira pré-paga em USD, sem mensalidade. Pague por cartão ou USDT/USDC, receba uma fatura em PDF a cada recarga e peça o modo sandbox para uma conta de desenvolvimento testar a API de verificação por SMS com números simulados. Use apenas para seus próprios produtos e contas legítimos, dentro dos termos de cada serviço e da nossa Política de Uso Aceitável.

Perguntas frequentes

Posso obter um número +993 para testar o cadastro do meu app?

Sim. Crie uma ativação com o id de país tm e o serviço escolhido e use o número retornado no seu próprio fluxo de cadastro.

Quanto custa um código de verificação do Turcomenistão na OTP Route?

A partir de $0.20 por código. O preço ao vivo por serviço vem do endpoint de preços e também aparece no painel.

Preciso incluir o prefixo 8 ao digitar um número turcomeno?

Não. O 8 serve apenas para discagem doméstica, então use +993 e o número nacional de oito dígitos.

Como sei que um webhook sobre um código +993 veio mesmo da OTP Route?

Verifique a assinatura HMAC-SHA256 do cabeçalho X-OTPRoute-Signature contra o corpo bruto e rejeite timestamps antigos.

O reembolso é automático quando nenhum SMS chega ao número do Turcomenistão?

Sim. Quando a janela de 20 minutos expira ou você cancela, o valor integral volta para a sua carteira.

Posso manter um número do Turcomenistão para logins recorrentes?

Não em autoatendimento. Números de longo prazo são oferecidos só para EUA e Canadá; escreva para o suporte se tiver uma necessidade especial.

Em que idioma chegam as mensagens OTP do Turcomenistão?

Depende do app; turcomeno, russo e inglês são todos possíveis, então extraia dígitos em vez de palavras.

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.