Ricevere codici SMS OTP della Repubblica Ceca con endpoint, webhook o dashboard

Su quali endpoint si basa l'API OTP per la Repubblica Ceca?

Tutto gira su https://otproute.com/api/v1 con una chiave Bearer con prefisso or_live_. Le chiavi si creano nella Developer console e un account può averne fino a 10, il che permette di dare a staging, CI e a un portatile locale credenziali separate, revocabili in modo indipendente. Il limite è di 300 richieste al minuto per account.

Un'esecuzione tipica con +420 si svolge così:

1. Recupera GET /api/v1/countries e GET /api/v1/services una volta per rilascio e mettili in cache. L'id del paese per la Repubblica Ceca è cz.
2. Chiedi a GET /api/v1/prices?country=cz&service=<id> il prezzo aggiornato della rotta che pensi di usare; cambia con il servizio e con la disponibilità.
3. Crea l'attivazione con POST /api/v1/activations e il corpo JSON {"service": "<id>", "country": "cz"}. La risposta ti dà un id di attivazione e il numero da digitare nel modulo di registrazione che stai testando.
4. Attendi il codice, via webhook oppure leggendo GET /api/v1/activations/{id} a intervalli moderati.
5. Se il test viene interrotto, rilascia il numero con POST /api/v1/activations/{id}/cancel così il blocco di fondi torna subito nel wallet.

Una chiamata a GET /api/v1/balance prima di una suite ampia è un modo economico per fallire subito se il wallet è scarico. Il riferimento completo è nella documentazione.

Come verifico i webhook per le attivazioni +420?

I webhook eliminano la necessità del polling e vanno bene per i test runner in parallelo. Punta uno dei tuoi endpoint (la Developer console ne consente 5 per account) al flusso ceco e iscrivilo a activation.sms_received, activation.expired e activation.cancelled.

Ogni richiesta porta un header X-OTPRoute-Signature nella forma t=<unix>,v1=<hex>. Ricostruisci la stringa <t>.<raw body> dai byte intatti della richiesta, calcola HMAC-SHA256 con il segreto di quell'endpoint, confronta il risultato con v1 in tempo costante e scarta tutto ciò il cui timestamp è troppo vecchio per essere una consegna recente. La nostra guida su come proteggere i webhook OTP con HMAC illustra un handler riga per riga.

Tratta gli eventi come legati all'id di attivazione e rendi l'handler idempotente: una consegna ritentata deve trovare l'attivazione già segnata come completata e rispondere semplicemente con successo. Il polling di GET /api/v1/activations/{id} resta un ripiego valido per gli script che girano dove non esiste un endpoint pubblico.

Quali servizi possono inviare codici a numeri cechi?

La rotta ceca copre attualmente più di 1.700 servizi. I nomi più popolari nell'ultima istantanea includono WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber e ChatGPT (OpenAI).

Questo elenco non è fisso. La disponibilità si muove durante la giornata, quindi il codice dovrebbe leggerla dall'API a runtime invece che da una tabella scritta a mano. Se un servizio che ti serve manca in un certo momento, potrebbe ricomparire più tardi, oppure una rotta vicina dell'Europa centrale potrebbe adattarsi al caso di test.

Come si memorizza e si analizza un numero di verifica ceco?

La numerazione ceca è chiusa: i numeri nazionali hanno nove cifre e non c'è prefisso interurbano, quindi la forma nazionale e quella internazionale differiscono solo per il +420 davanti. Questo rende la normalizzazione più semplice che in molti mercati, ma i moduli ricevono comunque spazi, un prefisso internazionale 00420 o le sole nove cifre. Elimina i separatori, converti 00 in +, aggiungi +420 se manca e memorizza il risultato in E.164.

I codici delle app rivolte al pubblico ceco arrivano di solito in ceco o in inglese. Il testo ceco usa segni diacritici come háček e čárka, e alcuni mittenti li tolgono per restare in un set di caratteri semplice, quindi un parser deve cercare il gruppo di cifre invece di cercare una frase intera.

I team usano un numero +420 per i test quando lanciano un prodotto per clienti cechi, controllano i testi di onboarding in ceco o verificano che un flusso di registrazione regionale accetti numeri senza zero iniziale. La pagina QA testing descrive come i team strutturano queste esecuzioni.

Cosa dovrebbe succedere se un codice ceco non arriva?

Alcuni servizi rifiutano i numeri virtuali e alcune rotte sono più lente in certe ore. Un codice mancato non costa nulla: se nessun SMS arriva entro la finestra di 20 minuti, o annulli prima, l'intero importo torna automaticamente nel wallet.

• Lascia scorrere la finestra prima di decidere che il tentativo è fallito.
• Controlla se il servizio che stai testando accetta del tutto numeri virtuali.
• Riprova più tardi, oppure prova un'altra rotta di paese supportata dal servizio.
• Inserisci pause tra i tentativi; riordinare in un ciclo serrato consuma il limite di richieste e di rado serve.
• Registra l'id di attivazione a ogni fallimento, così emergono gli schemi nelle varie esecuzioni.

Chi non è sviluppatore può usare la rotta +420 dalla dashboard?

Sì. Dopo la registrazione con email e un codice email a 6 cifre (o con l'accesso Google), apri l'OTP Gateway, scegli il servizio e la Repubblica Ceca, controlla il prezzo mostrato e ordina. Il numero di verifica ceco compare subito; incollalo nell'app e il codice appare sulla stessa schermata quando arriva. Annullare dalla dashboard riporta l'importo nel wallet esattamente come la chiamata API.

Esiste un numero ceco a lungo termine e come funziona la fatturazione?

Oggi non esiste un numero ceco a lungo termine in self-service. I Dedicated Numbers sono un prodotto per Stati Uniti e Canada, da $1.95/mese, con SMS in entrata e in uscita e chiamate dal browser; vedi i numeri virtuali per i dettagli. Se il tuo team ha bisogno di una linea +420 duratura, scrivi a [email protected] e chiedi, sapendo che la disponibilità dipende dalle norme locali e non è promessa.

La fatturazione è un solo wallet prepagato in USD senza canone mensile e senza piani da scegliere. I fondi entrano con carta o come USDT/USDC e ogni ricarica genera una fattura PDF inviata via email. Per il lavoro di integrazione, su richiesta un account di sviluppo può passare alla sandbox, così numeri e codici simulati esercitano l'intero flusso senza spendere fondi del wallet. Per l'account stesso è disponibile l'accesso a due fattori con TOTP.

Domande frequenti

Posso testare la registrazione ceca della mia app senza una SIM ceca?

Sì. Ordina un numero +420 dall'OTP Gateway per il servizio che stai testando, inseriscilo nella tua app e leggi il codice dalla dashboard, dall'API o da un webhook.

Qual è l'id del paese per la Repubblica Ceca nell'API di OTP Route?

Usa cz nel campo country di POST /api/v1/activations e nelle ricerche dei prezzi.

Quanto costa un codice di verifica ceco?

I codici partono da $0.20 per codice, e il prezzo esatto per ogni servizio viene restituito da GET /api/v1/prices e mostrato prima dell'ordine. Paghi solo se un codice arriva.

I numeri cechi richiedono uno zero iniziale?

No. I numeri cechi non hanno prefisso interurbano, quindi memorizzali come +420 seguito dalle nove cifre nazionali.

Per quanto tempo resta aperta un'attivazione +420?

Venti minuti. Se in quel tempo non arriva nulla, l'attivazione scade e il wallet viene rimborsato per intero.

L'instradamento OTP verso la Repubblica Ceca è adatto alla creazione massiva di account?

No. OTP Route serve per testare il tuo prodotto e gestire i tuoi account legittimi. Mantieni ogni attivazione +420 legata al tuo prodotto o al tuo account, nel rispetto dei termini di ciascun servizio e dell'Acceptable Use Policy di OTP Route.

Posso tenere lo stesso numero ceco per accessi futuri?

Non come prodotto self-service. I Dedicated Numbers a lungo termine esistono solo negli Stati Uniti e in Canada, e puoi scrivere al supporto per informarti sugli altri mercati.

I nomi dei servizi sono marchi dei rispettivi proprietari. OTP Route non è affiliata a essi. Usa i numeri in modo lecito e rispetta i termini di ciascun servizio e la nostra Politica di Utilizzo Accettabile.