Coletando códigos de verificação iemenitas (+967) por meio de uma API

Qual é o caminho mais curto na API até um código +967?

Aponte o seu cliente para https://otproute.com/api/v1 com uma chave Bearer do console do desenvolvedor; as chaves levam o prefixo or_live_. O id do país do Iêmen é ye.

1. Consulte os preços com GET /api/v1/prices?country=ye&service=<id>; a resposta informa quanto o código vai custar e se a rota está aberta.
2. Crie o pedido: POST /api/v1/activations com {"service": "whatsapp", "country": "ye"}. Você recebe de volta um id de ativação e o número +967.
3. Digite ou injete o número na etapa de verificação do seu próprio app.
4. Obtenha o código em GET /api/v1/activations/{id} ou em um evento de webhook.
5. Libere um pedido inacabado com POST /api/v1/activations/{id}/cancel.

GET /api/v1/services e GET /api/v1/countries mudam pouco, então guarde-os em cache pelo dia. Chamar GET /api/v1/balance antes de um lote permite que o job pare cedo quando o saldo estiver baixo. O limite de 300 requisições por minuto vale por conta, e até 10 chaves podem ser emitidas. Veja o guia de integração para um exemplo prático desse fluxo da API OTP do Iêmen.

Como verifico as entregas de webhook das ativações do Iêmen?

Registre um endpoint HTTPS no console do desenvolvedor (uma conta pode ter cinco) e assine activation.sms_received, além de activation.expired e activation.cancelled, para que o seu job saiba quando parar de esperar.

A verificação da assinatura segue uma única receita. Separe X-OTPRoute-Signature em t e v1, calcule o HMAC-SHA256 da string <t>.<raw body> usando o segredo do endpoint e compare o resultado com v1 por uma função de tempo constante. Recuse a requisição se o timestamp for mais antigo do que a sua tolerância. Como uma entrega pode ser repetida, torne o handler idempotente: guarde o id da ativação e ignore as repetições. Como proteger webhooks de OTP com HMAC trata de casos extremos como o desvio de relógio.

O que o meu parser deve esperar de mensagens em árabe?

O árabe é o idioma oficial do Iêmen, então muitos serviços enviam o texto ao redor em árabe. Isso tem consequências práticas para quem testa as próprias mensagens: a escrita árabe exige codificação UCS-2, o que limita um segmento de SMS a 70 caracteres, e o texto da direita para a esquerda pode deslocar o ponto onde o código aparece em uma notificação. Alguns modelos colocam os dígitos antes da frase, outros depois.

Escreva a etapa de extração para encontrar a sequência de dígitos, sejam quais forem as palavras ao redor. Também é sensato normalizar os numerais arábico-índicos (٠ a ٩) para dígitos ASCII, caso um remetente os use. As equipes fazem essas verificações ao localizar um app para falantes de árabe, ao atender clientes iemenitas que vivem pelo Golfo ou ao confirmar que uma conta de suporte regional ainda é verificada. A OTP Route retorna a mensagem como foi recebida, então o que você interpreta em um teste é o que um usuário receberia.

Como os números de telefone iemenitas são formatados?

O código do país é +967. Os celulares têm nove dígitos depois dele e começam por 7, formando +967 7XX XXX XXX. Se o usuário digitar um 0 doméstico na frente, remova-o antes de salvar e persista a string E.164 sem separadores; a formatação local pertence apenas à interface.

Casos de validação úteis para um número +967 para testes:

• O usuário escolhe +967 na lista de países e depois digita o número completo, incluindo o código de novo.
• Um número é colado com dígitos arábico-índicos copiados de um cartão de contato.
• Aparecem espaços ou traços entre os grupos de dígitos.

Cada um deles deve terminar no mesmo valor armazenado, o que mantém confiáveis as buscas e a deduplicação.

Quais serviços roteiam atualmente para números +967?

O Iêmen tem mais de 1.700 serviços no OTP Gateway. Entre as entradas mais usadas no snapshot ao vivo estão WhatsApp, Telegram, imo, Facebook, Instagram, TikTok, Snapchat, Google (Gmail & YouTube), X (Twitter), Microsoft & Outlook, Signal, Discord e Amazon.

A disponibilidade é um alvo móvel, então monte as suítes para consultar a API primeiro. Quem não é da engenharia pode fazer o mesmo trabalho pelo painel: abra uma conta com um código por e-mail ou com o login do Google, recarregue, escolha o Iêmen e o serviço, copie o número de verificação do Iêmen para o app e espere o código na página da ativação.

Por que um código do Iêmen pode não chegar, e qual é a solução?

Cada pedido dura 20 minutos. Se nenhum SMS chegar, ou se você cancelar antes disso, o valor integral volta para a sua carteira automaticamente; você só é cobrado pelos códigos que chegam.

Causas típicas e respostas:

• O serviço está lento naquele momento: deixe a janela correr antes de desistir.
• O serviço recusa números virtuais: confira a política dele; o reembolso cuida da tentativa que falhou.
• A rota está ocupada: tente mais tarde ou por outra rota de serviço.
• Um script refaz o pedido assim que falha: adicione um backoff para que ele não martele a rota.

Use esses números apenas para os seus próprios produtos e contas legítimos, siga os termos de cada serviço e respeite a Política de Uso Aceitável da OTP Route.

Posso manter um número iemenita por longo prazo e como ele é cobrado?

Não por autoatendimento. Os Números Virtuais Dedicados são oferecidos apenas nos Estados Unidos e no Canadá, comprados na hora a partir de $1.95/mês. As equipes que precisam de uma linha +967 duradoura podem escrever para [email protected]; se é possível fornecer uma depende das regras locais e nunca é certo.

A carteira da OTP Route é pré-paga em USD, sem assinatura nem plano. Recarregue por cartão ou USDT/USDC, e uma fatura em PDF é enviada por e-mail a cada recarga. Confira os valores atuais em preços e peça o sandbox em uma conta de desenvolvimento se quiser números e códigos simulados para o trabalho de integração.

Perguntas frequentes

Posso testar um fluxo de cadastro em árabe com um número iemenita e sem chip local?

Sim. Peça um número do OTP Gateway com o país ye, informe-o no seu próprio app e leia a mensagem em árabe ou inglês no painel ou por webhook.

Qual é o preço de um código de verificação +967?

Ele começa a partir de $0.20 por código e varia conforme o serviço; GET /api/v1/prices retorna o valor ao vivo. Os códigos que nunca chegam são reembolsados quando a janela de 20 minutos termina.

Como extraio o código se o SMS é lido da direita para a esquerda?

Procure a sequência de dígitos em vez de um padrão de frase e converta antes os numerais arábico-índicos para ASCII. Isso funciona em qualquer lado do texto em que o código esteja.

O número +967 é meu para ficar com ele?

Não, um número do OTP Gateway cobre uma única verificação. Os números duradouros são um produto dos EUA e do Canadá; para o Iêmen, escreva ao suporte para perguntar.

Posso integrar sem gastar saldo da carteira?

Sim, peça o sandbox em uma conta de desenvolvimento. Ele retorna números e códigos simulados, o suficiente para testar polling, webhooks e tratamento de erros.

Qual id de país a API usa para o Iêmen?

É ye. Informe-o nas consultas de preço e no corpo JSON de POST /api/v1/activations.

Por que um serviço recusou o meu número iemenita?

Alguns serviços não aceitam números virtuais. Cancele ou deixe a ativação expirar, e o dinheiro volta para a sua carteira automaticamente.

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.