API OTP Qatar : webhooks, polling et numéros de test +974

À quoi ressemble la séquence d'appels de l'API OTP Qatar ?

Tout se trouve sous https://otproute.com/api/v1, avec une authentification par clé Bearer commençant par or_live_. Vous pouvez détenir jusqu'à 10 clés ; donnez donc des clés distinctes à la CI, au staging et au script d'exploitation, et révoquez-en une sans toucher aux autres. Une activation +974 complète demande quatre appels au maximum :

1. GET /api/v1/prices?country=qa&service=<id> renvoie le prix en direct et vous indique que la route est ouverte pour ce service à l'instant.
2. POST /api/v1/activations avec {"service": "<id>", "country": "qa"} réserve un numéro qatari et renvoie un identifiant d'activation.
3. GET /api/v1/activations/{id} est l'appel de polling : il montre où en est la commande Qatar et inclut le code après livraison.
4. POST /api/v1/activations/{id}/cancel met fin à la commande plus tôt et recrédite le montant sur le portefeuille.

Deux aides complètent le tableau : GET /api/v1/services associe les noms aux identifiants de service, et GET /api/v1/balance permet à un pipeline de s'arrêter avant d'être à sec. Restez sous 300 requêtes par minute et par compte. La présentation pour développeurs rassemble les pages de référence.

Comment un gestionnaire de webhook doit-il traiter les événements d'activation Qatar ?

Le polling fonctionne, mais un webhook permet à votre exécuteur de tests de réagir dès qu'il se passe quelque chose. Enregistrez jusqu'à cinq endpoints et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled ; le premier transporte le code, et les deux autres indiquent à votre exécuteur d'arrêter d'attendre.

Chaque requête inclut X-OTPRoute-Signature sous la forme t=<unix>,v1=<hex>. Reconstituez la chaîne signée comme l'horodatage, un point et le corps brut de la requête, calculez le HMAC-SHA256 avec le secret de l'endpoint et comparez en temps constant. Rejetez tout horodatage périmé. Comme les nouvelles tentatives peuvent livrer plusieurs fois le même événement, enregistrez l'identifiant d'activation et ignorez les répétitions. Pour une implémentation de référence, lisez la capture d'OTP par webhook.

Quels services peuvent acheminer un code vers un numéro +974 ?

Le Qatar est l'une des routes les plus larges, avec plus de 1 600 services dans le dernier instantané. Parmi les plus courants : WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude et Discord.

L'inventaire évolue au fil de la journée ; considérez donc l'instantané comme une orientation et la réponse de l'API comme la vérité. Quelques services refusent les numéros virtuels ; dans ce cas, la commande expire simplement et l'argent est rendu. Chaque nom ci-dessus est une marque de son propriétaire, sans aucune affiliation sous-entendue.

Normaliser les numéros qataris dans vos jeux de test

Les numéros qataris comptent huit chiffres après +974 et n'ont pas de préfixe de ligne ; il n'y a donc rien à supprimer pour passer d'un numéro local au format international. Gardez vos jeux de test en E.164 (+974 plus huit chiffres), et nettoyez les saisies utilisateur avec 00974, des espaces ou un zéro initial parasite hérité des habitudes d'un autre pays.

L'arabe est la langue officielle, tandis que l'anglais est très répandu dans les affaires et auprès d'une population comptant une large part d'expatriés. Les SMS de vérification arrivent donc dans la langue que le service émetteur choisit pour le compte, souvent l'anglais ou l'arabe. Vérifiez que votre logique d'extraction trouve le code dans les deux écritures et que, dans une interface en arabe, le champ de saisie de l'OTP reste utilisable avec une mise en page de droite à gauche.

Les équipes testent la route du Qatar lorsqu'elles se lancent dans le CCG, localisent une application grand public pour des arabophones, gèrent des opérations d'hôtellerie ou de logistique à Doha, ou vérifient un compte professionnel régional sans y mettre le numéro personnel d'un employé. Le guide des tests en CI montre comment intégrer ces contrôles à des exécutions automatisées.

Lancer plutôt une vérification Qatar depuis le tableau de bord

Toute vérification n'exige pas un script. Dans le tableau de bord, ouvrez l'OTP Gateway, sélectionnez le Qatar et le service, examinez le prix affiché, puis confirmez. Copiez le numéro +974 dans l'application, demandez le SMS, et le code apparaît sur la commande. La fenêtre de 20 minutes court à partir du moment où vous passez la commande, et vous ne payez que si un code arrive.

Codes qui n'arrivent pas : une liste de débogage

• Avez-vous assez attendu ? Laissez l'activation aller au bout de sa fenêtre avant de la considérer comme échouée.
• Les numéros virtuels sont-ils acceptés ? Certains services les bloquent, et des tentatives répétées n'y changeront rien.
• La politique de nouvelle tentative est-elle saine ? Espacez et réessayez plus tard, ou passez à une autre route pour le même service. Recommander en boucle serrée gaspille votre limite de débit et aide rarement.
• Le gestionnaire est-il en bonne santé ? Si la vérification de signature échoue ou si l'endpoint renvoie une erreur, interrogez GET /api/v1/activations/{id} pour voir si le code a été livré alors que votre webhook l'a manqué.

Une activation qui se termine sans SMS, par expiration ou par annulation, est intégralement remboursée.

Existe-t-il une ligne qatarie de longue durée, et comment l'usage est-il facturé ?

Il n'existe pas de numéro de longue durée en libre-service pour le Qatar. Les numéros virtuels dédiés (votre propre ligne avec SMS entrants et sortants, transfert par webhook et appels depuis le navigateur) ne sont proposés qu'aux États-Unis et au Canada, à partir de $1.95/mois. Pour un besoin spécifique au Qatar, écrivez à [email protected] ; la réglementation locale détermine ce qui est possible.

L'usage pour le Qatar puise dans un seul portefeuille prépayé en USD, et rien n'est facturé chaque mois. Rechargez par carte ou en USDT/USDC, récupérez une facture PDF pour chaque recharge, et demandez le mode sandbox sur un compte de développement si vous voulez tester l'intégration avec des numéros simulés. Utilisez les numéros +974 uniquement pour vos propres produits et comptes professionnels légitimes, respectez les conditions de chaque service et suivez la politique d'utilisation acceptable d'OTP Route.

Questions fréquentes

Comment recevoir des codes SMS OTP du Qatar dans un test automatisé ?

Créez une activation avec le pays qa, saisissez le numéro renvoyé dans l'application testée et attendez le webhook activation.sms_received. OTP Route prend aussi en charge le polling de l'activation si votre exécuteur de tests ne peut pas accepter de requêtes entrantes.

Puis-je utiliser un numéro +974 pour des tests sans carte SIM qatarie ?

Oui. L'OTP Gateway fournit un numéro de vérification du Qatar pour un code, ce qui vous permet de tester des parcours d'inscription ou de connexion sans SIM ni appareil local.

Comment consulter les prix pour le Qatar avant de commander ?

Appelez GET /api/v1/prices?country=qa&service=<id> ou consultez le tableau de bord. Les tarifs démarrent à $0.20 par code et varient selon le service.

Suis-je facturé pour les activations Qatar qui échouent ?

Non. Vous n'êtes facturé que lorsqu'un code arrive ; les activations expirées ou annulées sont automatiquement remboursées sur le portefeuille.

Pourquoi tester avec un numéro qatari plutôt qu'avec un numéro d'un pays voisin ?

Choisissez le pays qui correspond au marché réel du compte. Si votre produit se lance au Qatar, un numéro +974 exerce exactement la gestion de l'indicatif, la langue et le routage OTP que verront vos clients, comme l'explique le routage OTP par pays.

Un compte de développement peut-il fonctionner sans fonds dans le portefeuille ?

Oui. Sur demande, un compte de développement peut être basculé en sandbox, qui renvoie des numéros et des codes simulés pour des tests de bout en bout.

Puis-je conserver un numéro qatari pour des connexions répétées ?

Pas en libre-service, car les lignes dédiées sont limitées aux États-Unis et au Canada. Écrivez à [email protected] si vous souhaitez vous renseigner sur une ligne qatarie de longue durée.

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.