Collecter des codes de vérification yéménites (+967) via une API

Quel est le chemin d'API le plus court vers un code +967 ?

Pointez votre client vers https://otproute.com/api/v1 avec une clé Bearer de la console Développeur ; les clés portent le préfixe or_live_. L'identifiant de pays du Yémen est ye.

1. Récupérez les prix avec GET /api/v1/prices?country=ye&service=<id> ; la réponse indique ce que coûtera le code et si la route est ouverte.
2. Créez la commande : POST /api/v1/activations avec {"service": "whatsapp", "country": "ye"}. Vous recevez un identifiant d'activation et le numéro +967.
3. Saisissez ou injectez le numéro dans l'étape de vérification de votre propre application.
4. Récupérez le code depuis GET /api/v1/activations/{id} ou depuis un événement de webhook.
5. Libérez une commande inachevée avec POST /api/v1/activations/{id}/cancel.

GET /api/v1/services et GET /api/v1/countries changent rarement ; mettez-les donc en cache pour la journée. Appeler GET /api/v1/balance avant un lot permet au job de s'arrêter tôt quand les fonds baissent. La limite de 300 requêtes par minute s'applique par compte, et jusqu'à 10 clés peuvent être émises. Consultez le guide d'intégration pour un exemple concret de ce parcours de l'API OTP Yémen.

Comment vérifier les livraisons de webhooks pour les activations du Yémen ?

Enregistrez un endpoint HTTPS dans la console Développeur (un compte peut en avoir cinq) et abonnez-vous à activation.sms_received, ainsi qu'à activation.expired et activation.cancelled pour que votre job sache quand cesser d'attendre.

La vérification de signature suit une seule recette. Séparez X-OTPRoute-Signature en t et v1, calculez le HMAC-SHA256 de la chaîne <t>.<raw body> avec le secret de l'endpoint, puis comparez le résultat à v1 avec une fonction à temps constant. Refusez la requête si l'horodatage dépasse votre tolérance. Comme une livraison peut être rejouée, rendez le traitement idempotent : enregistrez l'identifiant d'activation et ignorez les répétitions. Sécuriser les webhooks OTP avec HMAC traite des cas limites comme la dérive d'horloge.

À quoi mon analyseur doit-il s'attendre avec des messages en arabe ?

L'arabe est la langue officielle du Yémen ; de nombreux services envoient donc le texte environnant en arabe. Cela a des conséquences pratiques pour qui teste ses propres messages : l'écriture arabe exige l'encodage UCS-2, ce qui limite un segment de SMS à 70 caractères, et le texte de droite à gauche peut déplacer l'emplacement du code dans une notification. Certains modèles placent les chiffres avant la phrase, d'autres après.

Écrivez l'étape d'extraction pour trouver la suite de chiffres quels que soient les mots qui l'entourent. Il est aussi judicieux de normaliser les chiffres arabo-indiens (٠ à ٩) en chiffres ASCII au cas où un expéditeur les utiliserait. Les équipes effectuent ces contrôles lorsqu'elles localisent une application pour les arabophones, assistent des clients yéménites installés dans le Golfe, ou confirment qu'un compte de support régional se vérifie toujours. OTP Route renvoie le message tel qu'il a été reçu : ce que vous analysez dans un test est donc ce qu'un utilisateur recevrait.

Comment les numéros de téléphone yéménites sont-ils formatés ?

L'indicatif du pays est +967. Les numéros mobiles comptent neuf chiffres après lui et commencent par 7, ce qui donne la forme +967 7XX XXX XXX. Si un utilisateur saisit un 0 national devant, retirez-le avant d'enregistrer, et conservez la chaîne E.164 sans séparateurs ; la mise en forme locale n'a sa place que dans l'interface.

Cas de validation utiles pour un numéro +967 de test :

• L'utilisateur choisit +967 dans la liste des pays, puis retape le numéro complet en incluant de nouveau l'indicatif.
• Un numéro est collé avec des chiffres arabo-indiens copiés depuis une fiche de contact.
• Des espaces ou des tirets apparaissent entre les groupes de chiffres.

Chacun de ces cas doit aboutir à la même valeur stockée, ce qui garde les recherches et la déduplication fiables.

Quels services routent actuellement vers des numéros +967 ?

Le Yémen compte plus de 1 700 services sur l'OTP Gateway. Parmi les entrées fréquemment utilisées de l'instantané en direct : WhatsApp, Telegram, imo, Facebook, Instagram, TikTok, Snapchat, Google (Gmail & YouTube), X (Twitter), Microsoft & Outlook, Signal, Discord et Amazon.

La disponibilité est une cible mouvante ; concevez donc des suites qui interrogent d'abord l'API. Les personnes extérieures à l'ingénierie peuvent faire le même travail depuis le tableau de bord : ouvrez un compte avec un code par e-mail ou une connexion Google, rechargez, choisissez le Yémen et le service, puis copiez le numéro de vérification yéménite dans l'application et attendez le code sur la page d'activation.

Pourquoi un code du Yémen peut-il ne pas arriver, et comment y remédier ?

Chaque commande vit 20 minutes. Si aucun SMS n'arrive, ou si vous annulez avant, la totalité du montant retourne automatiquement sur votre portefeuille ; vous n'êtes facturé que pour les codes qui arrivent.

Causes typiques et réponses :

• Le service est lent à ce moment-là : laissez la fenêtre courir avant d'abandonner.
• Le service refuse les numéros virtuels : consultez sa politique ; le remboursement prend en charge la tentative ratée.
• La route est chargée : réessayez plus tard ou avec une autre route de service.
• Un script recommande dès qu'il rate : ajoutez un délai croissant pour qu'il ne martèle pas la route.

N'utilisez ces numéros que pour vos propres produits et comptes légitimes, respectez les conditions de chaque service et restez dans le cadre de la politique d'utilisation acceptable d'OTP Route.

Puis-je conserver un numéro yéménite longtemps, et comment est-il facturé ?

Pas en libre-service. Les numéros virtuels dédiés ne sont proposés qu'aux États-Unis et au Canada, achetés instantanément à partir de $1.95/month. Les équipes qui ont besoin d'une ligne +967 durable peuvent écrire à [email protected] ; la possibilité d'en fournir une dépend de la réglementation locale et n'est jamais certaine.

Le portefeuille OTP Route est prépayé en USD, sans abonnement ni formule. Alimentez-le par carte ou en USDT/USDC, et une facture PDF est envoyée par e-mail à chaque recharge. Consultez les tarifs en vigueur sur la page de tarification, et demandez la sandbox sur un compte de développement si vous voulez des numéros et des codes simulés pour le travail d'intégration.

Questions fréquentes

Puis-je tester un parcours d'inscription en arabe avec un numéro yéménite et sans SIM locale ?

Oui. Commandez un numéro de l'OTP Gateway avec le pays ye, saisissez-le dans votre propre application et lisez le message en arabe ou en anglais dans le tableau de bord ou via un webhook.

Quel est le prix d'un code de vérification +967 ?

Il démarre à $0.20 par code et varie selon le service ; GET /api/v1/prices renvoie le tarif en direct. Les codes qui n'arrivent jamais sont remboursés à la fin de la fenêtre de 20 minutes.

Comment extraire le code si le SMS se lit de droite à gauche ?

Cherchez la suite de chiffres plutôt qu'un motif de phrase, et convertissez d'abord les chiffres arabo-indiens en ASCII. Cela fonctionne quel que soit le côté du texte où se trouve le code.

Le numéro +967 est-il à moi pour le garder ?

Non, un numéro de l'OTP Gateway couvre une seule vérification. Les numéros durables sont un produit États-Unis et Canada ; pour le Yémen, écrivez au support pour vous renseigner.

Puis-je intégrer sans dépenser le solde du portefeuille ?

Oui, demandez la sandbox sur un compte de développement. Elle renvoie des numéros et des codes simulés, ce qui suffit pour tester le polling, les webhooks et la gestion des erreurs.

Quel identifiant de pays l'API utilise-t-elle pour le Yémen ?

C'est ye. Passez-le dans les recherches de prix et dans le corps JSON de POST /api/v1/activations.

Pourquoi un service a-t-il refusé mon numéro yéménite ?

Certains services n'acceptent pas les numéros virtuels. Annulez ou laissez l'activation expirer, et l'argent retourne automatiquement sur votre portefeuille.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.