Recevoir des codes OTP SMS tchèques via les endpoints, les webhooks ou le tableau de bord

Sur quels endpoints repose l'API OTP République tchèque ?

Tout passe par https://otproute.com/api/v1 avec une clé Bearer préfixée or_live_. Vous créez les clés dans la console Développeur, et un compte peut en contenir jusqu'à 10, ce qui permet de donner au staging, à la CI et à un portable local des identifiants distincts, révocables indépendamment. La limite de débit est de 300 requêtes par minute et par compte.

Un déroulé typique en +420 ressemble à ceci :

1. Appelez GET /api/v1/countries et GET /api/v1/services une fois par déploiement et mettez les résultats en cache. L'identifiant de pays tchèque est cz.
2. Demandez GET /api/v1/prices?country=cz&service=<id> pour connaître le prix en direct de la route que vous comptez utiliser ; il varie selon le service et le stock.
3. Créez l'activation avec POST /api/v1/activations et le corps JSON {"service": "<id>", "country": "cz"}. La réponse vous donne un identifiant d'activation et le numéro à saisir dans le formulaire d'inscription testé.
4. Attendez le code, par webhook ou en lisant GET /api/v1/activations/{id} à intervalle modéré.
5. Si le test est interrompu, libérez le numéro avec POST /api/v1/activations/{id}/cancel pour que la somme retenue retourne aussitôt au portefeuille.

Un appel à GET /api/v1/balance avant le lancement d'une grosse suite de tests est un moyen peu coûteux d'échouer vite quand le solde est bas. La référence complète est dans la documentation.

Comment vérifier les webhooks des activations +420 ?

Les webhooks évitent le polling et conviennent aux exécuteurs de tests parallèles. Pointez l'un de vos endpoints (la console Développeur en autorise 5 par compte) vers le flux tchèque et abonnez-le à activation.sms_received, activation.expired et activation.cancelled.

Chaque requête porte un en-tête X-OTPRoute-Signature de la forme t=<unix>,v1=<hex>. Reconstituez la chaîne <t>.<raw body> à partir des octets bruts de la requête, calculez le HMAC-SHA256 avec le secret de cet endpoint, comparez le résultat à v1 en temps constant, et rejetez tout ce dont l'horodatage est trop ancien pour être une livraison récente. Notre guide sur la sécurisation des webhooks OTP avec HMAC détaille un gestionnaire ligne par ligne.

Traitez les événements comme indexés sur l'identifiant d'activation et rendez le gestionnaire idempotent : une livraison rejouée doit trouver l'activation déjà marquée comme terminée et simplement renvoyer un succès. Interroger GET /api/v1/activations/{id} reste un repli valable pour les scripts exécutés là où aucun endpoint public n'existe.

Quels services peuvent envoyer des codes à des numéros tchèques ?

La route tchèque couvre actuellement plus de 1 700 services. Parmi les noms populaires du dernier relevé : WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber et ChatGPT (OpenAI).

Cette liste n'est pas figée. Le stock évolue au fil de la journée : votre code doit donc lire la disponibilité auprès de l'API à l'exécution plutôt que dans une table codée en dur. Si un service dont vous avez besoin manque à un instant donné, il peut réapparaître plus tard, ou une route voisine d'Europe centrale peut convenir au cas de test.

Comment stocker et analyser un numéro de vérification tchèque ?

La numérotation tchèque est fermée : les numéros nationaux comptent neuf chiffres et il n'y a pas de préfixe de tronc, de sorte que la forme nationale et la forme internationale ne diffèrent que par le +420 initial. La normalisation est donc plus simple que sur beaucoup de marchés, mais les formulaires reçoivent encore des espaces, un préfixe international 00420 ou simplement les neuf chiffres. Supprimez les séparateurs, convertissez 00 en +, ajoutez +420 s'il manque, et stockez le résultat en E.164.

Les codes des applications destinées au public tchèque arrivent généralement en tchèque ou en anglais. Le tchèque utilise des signes diacritiques comme le háček et la čárka, et certains expéditeurs les retirent pour rester dans un jeu de caractères simple : un analyseur doit donc chercher le groupe de chiffres plutôt que de comparer une phrase entière.

Les équipes utilisent un numéro +420 pour tester lorsqu'elles lancent un produit pour des clients tchèques, vérifient les textes d'onboarding en tchèque, ou s'assurent qu'un parcours d'inscription régional accepte des numéros sans zéro initial. La page tests QA présente la manière dont les équipes structurent ces exécutions.

Que faire quand un code tchèque n'arrive jamais ?

Certains services refusent les numéros virtuels, et certaines routes sont plus lentes à certaines heures. Un code manqué ne coûte rien : si aucun SMS n'arrive dans la fenêtre de 20 minutes, ou si vous annulez avant, la totalité du montant retourne automatiquement sur le portefeuille.

• Laissez la fenêtre aller à son terme avant de considérer la tentative comme un échec.
• Vérifiez si le service que vous testez accepte les numéros virtuels.
• Réessayez plus tard, ou essayez une autre route pays prise en charge par le service.
• Espacez les tentatives ; recommander en boucle serrée consomme la limite de débit et aide rarement.
• Consignez l'identifiant d'activation à chaque échec pour faire apparaître des tendances d'une exécution à l'autre.

Les non-développeurs peuvent-ils utiliser la route +420 depuis le tableau de bord ?

Oui. Après vous être inscrit avec votre e-mail et un code à 6 chiffres reçu par e-mail (ou via la connexion Google), ouvrez l'OTP Gateway, choisissez le service et la République tchèque, vérifiez le prix affiché, puis passez commande. Le numéro de vérification tchèque apparaît immédiatement ; collez-le dans l'application, et le code s'affiche sur le même écran dès son arrivée. L'annulation depuis le tableau de bord recrédite le portefeuille de la même façon que l'appel d'API.

Existe-t-il un numéro tchèque longue durée, et comment fonctionne la facturation ?

Il n'existe aujourd'hui aucun numéro tchèque longue durée en libre-service. Les Dedicated Numbers sont un produit réservé aux États-Unis et au Canada, dès $1.95/mois, avec SMS entrants et sortants et appels depuis le navigateur ; consultez les numéros virtuels pour le détail. Si votre équipe a besoin d'une ligne +420 durable, écrivez à [email protected] pour demander, en sachant que la disponibilité dépend de la réglementation locale et n'est pas promise.

La facturation repose sur un seul portefeuille USD prépayé, sans abonnement mensuel ni formule à choisir. Les fonds entrent par carte ou en USDT/USDC, et chaque recharge déclenche une facture PDF envoyée par e-mail. Pour l'intégration, un compte de développement peut être basculé en sandbox sur demande, afin que des numéros et des codes simulés exercent tout le flux sans dépenser les fonds du portefeuille. L'authentification à deux facteurs TOTP est disponible pour le compte lui-même.

Questions fréquentes

Puis-je tester l'inscription tchèque de mon application sans carte SIM tchèque ?

Oui. Commandez un numéro +420 auprès de l'OTP Gateway pour le service que vous testez, saisissez-le dans votre application et lisez le code dans le tableau de bord, via l'API ou par webhook.

Quel est l'identifiant de pays de la République tchèque dans l'API OTP Route ?

Utilisez cz dans le champ country de POST /api/v1/activations et dans les requêtes de prix.

Combien coûte un code de vérification tchèque ?

Les codes démarrent à $0.20 par code ; le prix exact de chaque service est renvoyé par GET /api/v1/prices et affiché avant la commande. Vous ne payez que si un code arrive.

Les numéros tchèques nécessitent-ils un zéro initial ?

Non. Les numéros tchèques n'ont pas de préfixe de tronc : stockez-les sous la forme +420 suivie des neuf chiffres nationaux.

Combien de temps une activation +420 reste-t-elle ouverte ?

Vingt minutes. Si rien n'arrive dans ce délai, l'activation expire et le portefeuille est intégralement remboursé.

Le routage OTP vers la République tchèque convient-il à la création de comptes en masse ?

Non. OTP Route sert à tester votre propre produit et à gérer vos propres comptes légitimes. Rattachez chaque activation +420 à votre propre produit ou compte, dans le respect des conditions de chaque service et de la politique d'utilisation acceptable d'OTP Route.

Puis-je garder le même numéro tchèque pour des connexions ultérieures ?

Pas en libre-service. Les Dedicated Numbers longue durée n'existent qu'aux États-Unis et au Canada, et vous pouvez écrire au support pour vous renseigner sur d'autres marchés.

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.