Português
Automatizando códigos de verificação +998 para lançamentos e QA no Uzbequistão
A OTP Route pode entregar aos seus sistemas os códigos de verificação SMS do Uzbequistão (+998): peça um número de uso único no OTP Gateway e depois colete o código por um webhook assinado, polling REST ou o painel. Os preços começam em $0.20 por código, o valor ao vivo de cada serviço vem da API, e tudo o que não chegar em 20 minutos é reembolsado na sua carteira.
Como uma ativação +998 vai do pedido ao código?
Comece criando uma chave Bearer no console do desenvolvedor. As chaves têm o prefixo or_live_, toda chamada vai para https://otproute.com/api/v1, e você pode manter até 10 chaves, o que ajuda a separar as builds noturnas do QA manual.
Seu cliente primeiro lê GET /api/v1/countries, onde o Uzbequistão aparece como uz, e GET /api/v1/services para obter o id do serviço. Depois consulta GET /api/v1/prices?country=uz&service=<id> para saber quanto o par custa agora e se há números disponíveis. Se a resposta servir ao teste, ele envia POST /api/v1/activations com um corpo como {"service": "instagram", "country": "uz"} e recebe um id de ativação junto com um número +998.
O teste então digita esse número na sua própria tela de cadastro ou login. A partir daí, o código chega até você como um evento de webhook ou por GET /api/v1/activations/{id}. Um teste que for interrompido deve chamar POST /api/v1/activations/{id}/cancel para liberar a reserva. Verificar GET /api/v1/balance no início de uma execução evita suítes pela metade. A referência da API documenta cada requisição dessa API de verificação por SMS.
O que um receptor de webhook confiável para códigos do Uzbequistão precisa ter?
Três coisas: autenticação, proteção contra replay e idempotência.
- Autenticação. Cada entrega inclui
X-OTPRoute-Signatureno formatot=<unix>,v1=<hex>. Monte a string<t>.<raw body>, assine-a com HMAC-SHA256 e o segredo do endpoint e compare comv1em tempo constante. - Proteção contra replay. Rejeite qualquer requisição cujo valor de
tseja mais antigo que uma tolerância curta que você definir. - Idempotência. Guarde o id da ativação quando um evento for processado e confirme as duplicatas sem agir sobre elas de novo.
Inscreva-se em activation.sms_received para o caminho feliz e em activation.expired e activation.cancelled para que o seu executor de testes possa encerrar as falhas. Você pode registrar até 5 endpoints por conta, por exemplo um por ambiente. O polling continua sendo uma alternativa válida; o teto de 300 requisições por minuto comporta várias ativações simultâneas consultadas a cada poucos segundos. Um padrão mais completo está em captura de OTP por webhook.
Por que as equipes incluem o Uzbequistão no plano de roteamento de OTP?
O Uzbequistão é o país mais populoso da Ásia Central, e as empresas que se expandem pela região muitas vezes precisam de um número +998 para testes antes de ter um parceiro local. Os motivos típicos incluem o lançamento de um produto voltado a usuários uzbeques, uma rodada de QA nas traduções para uzbeque e russo e equipes regionais de operações que verificam contas de fornecedores ou marketplaces ligadas ao mercado.
O Telegram é um dos aplicativos de mensagens mais usados no país, então fluxos que vinculam uma conta do Telegram, ou que dependem dele para suporte, merecem um teste próprio. Planejando vários mercados ao mesmo tempo? O guia de roteamento por país explica como escolher rotas por caso de teste.
Como analisar, armazenar e ler números +998?
Um número completo do Uzbequistão é +998 seguido de nove dígitos, e os dois primeiros deles costumam identificar a operadora ou a região. Os hábitos de discagem doméstica mudaram ao longo dos anos, então as pessoas podem digitar o número com dígitos extras no início ou sem o código do país. Normalize tudo para +998 mais nove dígitos antes de salvar e mantenha a formatação de exibição, como +998 90 123 45 67, puramente cosmética.
O uzbeque é o idioma oficial. Oficialmente é escrito em alfabeto latino, embora o cirílico continue comum, e o russo é amplamente compreendido. Os textos de verificação podem, portanto, chegar em uzbeque em qualquer um dos alfabetos, em russo ou em inglês. Escreva o seu extrator para procurar a sequência de dígitos em vez de uma palavra-chave e teste-o nos três idiomas.
Quais apps podem receber SMS OTP do Uzbequistão pelo gateway?
Mais de 1.800 serviços estão disponíveis na rota do Uzbequistão. O snapshot ao vivo traz Telegram, WhatsApp, Instagram, Google (Gmail & YouTube), TikTok, Facebook, Microsoft & Outlook, Amazon, Discord, Snapchat, Signal, Viber, ChatGPT (OpenAI), Claude e WeChat.
A cobertura não é fixa. Um serviço aberto de manhã pode estar indisponível mais tarde, então deixe o endpoint de preços decidir em tempo de execução em vez de supor um resultado da execução de ontem.
Posso pedir um número de verificação do Uzbequistão sem a API?
O painel espelha a API para quem prefere clicar:
- Crie a conta com um endereço de e-mail e o código de 6 dígitos que você receber, ou use o login com o Google. Ative o TOTP na conta.
- Coloque saldo na carteira.
- Selecione o Uzbequistão e o serviço; o preço aparece antes de você confirmar.
- Use o número +998 no app que você está verificando.
- Leia o código na tela da ativação quando ele chegar.
E se o código do Uzbequistão não chegar a tempo?
Uma ativação +998 fica ativa por 20 minutos, e a cobrança só se aplica quando um código é de fato recebido. Se ela expirar, ou se você cancelar, a carteira recebe o valor integral de volta sem abrir chamado de suporte.
Se faltarem códigos, siga esta lista:
- Espere a janela terminar; a velocidade de entrega varia conforme o serviço e a rota.
- Tente de novo mais tarde, ou escolha outra rota de serviço quando o teste permitir.
- Verifique se o serviço recusa números virtuais, o que alguns fazem. É por isso que a regra de reembolso existe.
- Espace as novas tentativas em vez de disparar pedidos em sequência e registre os ids das ativações para análise posterior.
Há linhas +998 de longo prazo e cobrança em sandbox?
Não existe número de longo prazo em autoatendimento para o Uzbequistão. A OTP Route vende Números Dedicados apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS de entrada, SMS de saída e chamadas pelo navegador. Para uma linha uzbeque duradoura, escreva para [email protected]; se é possível arranjar uma depende das regras locais e não é certo.
Os pagamentos usam uma única carteira pré-paga em USD, pague conforme o uso, sem assinatura. Recarregue por cartão ou USDT/USDC e espere uma fatura em PDF por e-mail a cada recarga. Contas de desenvolvimento podem pedir o modo sandbox, que simula números e códigos para que o CI rode sem tocar nos fundos da carteira.
Mantenha o uso legítimo: teste e opere 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
Posso verificar o fluxo de cadastro uzbeque do meu app de fora do Uzbequistão?
Sim. Um número +998 do OTP Gateway recebe o código onde quer que sua equipe esteja, e você o lê no painel ou pela API.
Qual id de país a API OTP do Uzbequistão usa?
Use uz na consulta de preços e no corpo de POST /api/v1/activations.
Quanto custa um número +998 para testes?
A partir de $0.20 por código. Cada serviço tem seu próprio preço ao vivo, retornado por GET /api/v1/prices e exibido antes de você confirmar um pedido.
As mensagens OTP do Uzbequistão virão em alfabeto latino ou cirílico?
Ambos são possíveis, e alguns serviços enviam em russo ou inglês. Capture o código numérico em vez do texto ao redor.
Sou cobrado se um código do Uzbequistão nunca chegar?
Não. Uma ativação do Uzbequistão que expira vazia após 20 minutos, ou que você cancela, é reembolsada integralmente na carteira sem nenhum pedido.
Posso manter um número do Uzbequistão para logins repetidos?
Não em autoatendimento. Os números de uso único atendem a um único código; contas que precisam entrar de novo ficam melhor com um Número Dedicado dos EUA ou do Canadá, ou você pode escrever ao suporte para perguntar sobre o Uzbequistão.
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.