Intégrer les codes SMS éthiopiens (+251) à votre pipeline de test

Quels appels d'API permettent de récupérer un code de vérification éthiopien ?

Le routage OTP vers l'Éthiopie se résume à cinq appels HTTP simples sur https://otproute.com/api/v1. Authentifiez chacun avec une clé Bearer commençant par or_live_, générée dans la console développeur ; un compte peut contenir jusqu'à 10 clés, de sorte que la CI, la préproduction et un portable local peuvent chacun utiliser des identifiants distincts.

1. GET /api/v1/countries liste toutes les routes, et l'Éthiopie y figure avec l'identifiant et.
2. GET /api/v1/services renvoie les identifiants de service, tandis que GET /api/v1/prices?country=et&service=<id> indique le prix actuel et la disponibilité de la paire que vous comptez tester.
3. POST /api/v1/activations avec {"service": "telegram", "country": "et"} réserve un numéro +251 et renvoie un identifiant d'activation.
4. Saisissez ce numéro dans le champ téléphone du produit testé et déclenchez son SMS.
5. Lisez le code depuis un événement de webhook ou en interrogeant GET /api/v1/activations/{id}, et abandonnez proprement une exécution avec POST /api/v1/activations/{id}/cancel.

L'inventaire évolue au fil de la journée : appelez donc le endpoint des prix à l'exécution plutôt que de coder quoi que ce soit en dur. Un rapide GET /api/v1/balance avant le début de la suite permet à un job de s'arrêter tôt quand le portefeuille est presque vide. Les formats de requête et de réponse de cette API de vérification par SMS figurent dans la documentation développeur.

Comment brancher un webhook signé pour les activations +251 ?

L'interrogation suffit pour un test isolé, mais des jobs parallèles sont plus faciles à raisonner quand les événements vous sont poussés. Enregistrez jusqu'à 5 endpoints de webhook par compte et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled.

Chaque requête porte X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalculez le HMAC-SHA256 sur <t>.<raw body> avec le secret de l'endpoint, comparez le résultat à v1 par une vérification en temps constant, et refusez l'appel si l'horodatage est périmé. Vérifiez sur les octets bruts avant qu'aucun analyseur JSON n'y touche.

Partez du principe qu'un événement peut être livré plusieurs fois : indexez le gestionnaire sur l'identifiant d'activation et ignorez les doublons, afin qu'un événement rejoué ne remplisse jamais deux fois un champ OTP. Si vous restez sur l'interrogation, un intervalle de quelques secondes reste très en deçà de la limite de 300 requêtes par minute. Notre guide sur la sécurisation des webhooks OTP avec HMAC inclut un gestionnaire de référence.

Quels services peuvent recevoir des codes SMS OTP d'Éthiopie en ce moment ?

La route Éthiopie référence actuellement plus de 1 700 services. Parmi les entrées populaires du relevé en direct : WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, imo et Netflix.

Considérez cette liste comme un instantané. La disponibilité d'un service donné peut changer en quelques heures, raison pour laquelle l'API la renvoie en direct plutôt que dans un tableau statique. Interrogez les endpoints des pays et des prix au début de chaque exécution, et parcourez le catalogue complet dans le tableau de bord si vous cherchez un service moins courant.

Que doivent savoir les équipes QA sur les formats +251 et la langue des SMS ?

Un numéro éthiopien au format E.164 est +251 suivi de neuf chiffres. En local, on compose un 0 initial devant ces neuf chiffres : les utilisateurs saisiront donc souvent 09… dans votre formulaire. Retirez ce zéro de préfixe national, ajoutez +251 et stockez la chaîne E.164 canonique, en n'affichant le style local que dans l'interface. Couvrez les deux saisies, ainsi que les espaces et les tirets, car la validation du champ téléphone est l'endroit où se cachent de nombreux bugs d'inscription.

L'amharique est la langue de travail fédérale et s'écrit en alphabet éthiopien (guèze), tandis que l'oromo, le tigrigna et le somali sont largement utilisés dans leurs régions. La plupart des services internationaux envoient les codes en anglais, mais un modèle localisé peut arriver en amharique. Extrayez les chiffres avec un motif plutôt qu'en recherchant les mots environnants, et assurez-vous que vos journaux stockent correctement l'UTF-8.

Les équipes testent généralement cette route lors du lancement d'une application pour des utilisateurs éthiopiens, pour vérifier une localisation en amharique, ou pour servir des clients de la diaspora qui s'inscrivent avec un numéro de leur pays d'origine. Si votre produit affiche des dates, le calendrier propre à l'Éthiopie constitue un cas de localisation distinct qui mérite d'être ajouté. La page QA testing montre comment d'autres équipes structurent ce type de suites.

Les non-développeurs peuvent-ils obtenir un numéro de vérification éthiopien depuis le tableau de bord ?

Oui. Les chefs de produit et le personnel du support peuvent exécuter le même flux sans écrire de code :

1. Créez un compte avec votre e-mail et un code à 6 chiffres, ou avec la connexion Google, puis activez l'authentification à deux facteurs TOTP.
2. Alimentez le portefeuille.
3. Choisissez l'Éthiopie, sélectionnez le service et lisez le prix affiché avant de confirmer.
4. Collez le numéro +251 dans l'application que vous vérifiez.
5. Gardez l'activation ouverte ; le code s'y affiche dès qu'il est reçu.

De nombreuses équipes utilisent cette voie pour des vérifications ponctuelles pendant que les ingénieurs pilotent la même route via l'API.

Que se passe-t-il si le code +251 n'arrive jamais ?

Chaque activation reste ouverte 20 minutes. Vous ne payez que si le code arrive ; si la fenêtre se ferme sans SMS, ou si vous annulez, le montant complet retourne automatiquement dans le portefeuille.

Quand rien n'arrive :

• Laissez la fenêtre aller à son terme avant de conclure à un échec, car le délai dépend du service et de la route.
• Réessayez plus tard, ou passez à une autre route de service si votre cas de test le permet.
• Vérifiez que le service accepte bien les numéros virtuels. Certains les refusent, et le remboursement existe précisément pour cette situation.
• Ne recommandez pas en boucle rapprochée. Espacez les nouvelles tentatives et consignez chaque identifiant d'activation pour faire apparaître les tendances.

L'article sur la réduction des échecs de livraison OTP liste d'autres vérifications.

Existe-t-il une ligne éthiopienne longue durée, et comment la facturation fonctionne-t-elle ?

OTP Route ne propose pas de numéro longue durée en libre-service en Éthiopie. Les Dedicated Numbers, des lignes que vous conservez tant qu'elles sont renouvelées, sont un produit réservé aux États-Unis et au Canada, dès $1.95/month. Si votre équipe a besoin d'une ligne +251 durable, écrivez à [email protected] pour poser la question ; la disponibilité dépend de la réglementation locale et n'est pas garantie.

Les activations éthiopiennes puisent dans un seul portefeuille prépayé en USD, sans frais mensuels ni forfait à choisir. Alimentez-le par carte ou en stablecoins USDT/USDC ; une facture PDF arrive dans votre boîte de réception après chaque recharge. Avant de dépenser de vrais fonds pour une nouvelle intégration, demandez le mode sandbox pour un compte de développement : il renvoie des numéros et des codes simulés, de sorte que tout le flux peut être exercé de bout en bout.

Les numéros de test éthiopiens d'OTP Route servent à vérifier des produits et des comptes que votre organisation possède réellement ; les conditions de chaque service s'appliquent toujours, de même que notre Acceptable Use Policy.

Questions fréquentes

Puis-je tester le parcours d'inscription éthiopien de mon application sans carte SIM locale ?

Oui. Commandez un numéro +251 pour votre service auprès de l'OTP Gateway, saisissez-le dans votre application et lisez le code dans le tableau de bord ou via l'API. Vous n'êtes facturé que si le code arrive.

Quel est l'identifiant de l'Éthiopie dans l'API OTP Route ?

C'est et. Envoyez et dans le champ country lors de la création d'une activation éthiopienne et lors de la consultation des prix.

Combien coûte un numéro +251 pour des tests ?

Les codes démarrent dès $0.20 par code. Le montant exact pour chaque service est renvoyé par GET /api/v1/prices et affiché dans le tableau de bord avant la commande.

Dois-je stocker les numéros éthiopiens avec le zéro initial ?

Non. Conservez la forme E.164, +251 plus neuf chiffres, et supprimez le 0 local chaque fois qu'un utilisateur le saisit. N'appliquez le format local qu'à l'écran.

Les SMS de vérification éthiopiens arriveront-ils en amharique ?

Généralement en anglais, même si un service peut utiliser un modèle amharique en écriture éthiopienne. Analysez les chiffres plutôt que la formulation, et les deux versions fonctionneront.

Puis-je conserver un numéro éthiopien pour des connexions ultérieures ?

Pas en libre-service, car un numéro à usage unique couvre un seul code. Pour un compte qui doit se reconnecter, un Dedicated Number aux États-Unis ou au Canada est adapté, ou vous pouvez écrire au support pour poser la question au sujet de l'Éthiopie.

Peut-on essayer l'API OTP Éthiopie sans dépenser les fonds du portefeuille ?

Oui. Demandez le mode sandbox sur un compte de développement : il renverra des numéros et des codes simulés, ce qui vous permet de tester l'intégration de bout en bout.

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.