Ricevere codici di verifica indiani (+91) tramite un'API

Che aspetto ha la sequenza di chiamate dell'API OTP per l'India?

L'intero flusso è una manciata di richieste su https://otproute.com/api/v1, autenticate con una chiave Bearer che inizia con or_live_. Le chiavi si creano nella console sviluppatori, fino a 10 per account, così ogni ambiente può averne una propria.

1. Chiama GET /api/v1/countries una volta e mettilo in cache. L'id paese dell'India è in.
2. Chiama GET /api/v1/prices?country=in&service=<id> per il servizio sotto test. Restituisce prezzo e disponibilità in tempo reale, quindi leggilo a ogni esecuzione.
3. Ordina con POST /api/v1/activations e un corpo JSON come {"service": "telegram", "country": "in"}. La risposta ti dà un id di attivazione e un numero +91.
4. Inserisci quel numero nella schermata di registrazione o di accesso della tua app.
5. Raccogli il codice tramite webhook o facendo polling su GET /api/v1/activations/{id}. Se il test si interrompe prima, chiama POST /api/v1/activations/{id}/cancel.

Controlla GET /api/v1/balance all'inizio di una suite così l'esecuzione fallisce subito. L'API consente 300 richieste al minuto, più che sufficienti per un polling ogni pochi secondi. I dettagli di richieste e risposte sono nella documentazione API.

Come va costruito un gestore webhook per i codici +91?

Un webhook firmato scala meglio del polling quando i job girano in parallelo. Registra un endpoint nella console sviluppatori (fino a 5 per account) e ascolta activation.sms_received, activation.expired e activation.cancelled.

Ogni consegna porta un header X-OTPRoute-Signature della forma t=<unix>,v1=<hex>. Per verificarlo, calcola l'HMAC-SHA256 della stringa <t>.<raw body> con il secret di quell'endpoint e confronta il risultato con v1 in tempo costante. Due dettagli fanno inciampare spesso:

• Calcola l'hash sui byte grezzi della richiesta, mai su un oggetto JSON riserializzato; l'ordine delle chiavi e gli spazi cambiano il digest.
• Rifiuta i timestamp più vecchi di pochi minuti, così una richiesta catturata non può essere riprodotta.

Basa le scritture sull'id dell'attivazione in modo che una consegna duplicata diventi un'operazione nulla, e conferma con un 2xx prima di eseguire lavori lenti. Il nostro approfondimento su proteggere i webhook OTP con HMAC tratta il passaggio di confronto riga per riga.

Quali servizi possono inviare codici a numeri indiani?

La rotta dell'India elenca attualmente più di 2.300 servizi. Tra le voci popolari dell'istantanea in tempo reale ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Discord, Uber e Snapchat.

La disponibilità cambia durante la giornata, ed è per questo che l'API la riporta in tempo reale. Se la tua matrice di test dipende da un servizio, interroga i prezzi per in prima dell'esecuzione e salta il test in modo pulito quando quella rotta è chiusa. Usa queste rotte solo per i tuoi prodotti e account, rispetta i termini di ciascun servizio e tieni presente che si applica l'Acceptable Use Policy di OTP Route.

I non sviluppatori possono ordinare un numero di verifica indiano dalla dashboard?

Sì. Il personale operativo e gli account manager delle agenzie possono saltare l'API:

1. Crea un account con la tua email e un codice email a 6 cifre, oppure con l'accesso Google, poi attiva l'autenticazione a due fattori TOTP.
2. Ricarica il wallet.
3. Scegli l'India e il servizio, controlla il prezzo a schermo e fai l'ordine.
4. Digita il numero +91 nell'app che stai configurando; il codice compare nella pagina dell'attivazione appena l'SMS arriva.

La dashboard e l'API condividono un'unica finestra, un'unica regola di rimborso e un unico wallet.

Cosa devo fare quando nessun codice arriva entro 20 minuti?

Ogni attivazione resta aperta per 20 minuti. Paghi solo se l'SMS arriva: quando la finestra si chiude vuota, o annulli prima, l'intero importo torna automaticamente sul tuo wallet e il tuo webhook riceve activation.expired o activation.cancelled.

Se un codice manca:

• Lascia scorrere la finestra prima di reagire; un servizio può semplicemente essere più lento del solito a inviare.
• Conferma che il servizio accetti i numeri virtuali. Alcune piattaforme li rifiutano, il che è una politica loro e non un guasto di consegna.
• Riprova più tardi, oppure testa con un'altra rotta di servizio.
• Non riordinare mai in un ciclo serrato. Fai un backoff tra i tentativi per non sprecare impegno su una rotta che rifiuta i numeri.

Una trattazione più ampia della strategia di nuovi tentativi è in ridurre i fallimenti nella consegna degli OTP.

Come vanno salvati e normalizzati i numeri di telefono indiani?

I cellulari indiani sono lunghi dieci cifre e in pratica iniziano con 6, 7, 8 o 9. In India si scrivono spesso con uno 0 iniziale come prefisso interurbano, oppure divisi cinque e cinque con uno spazio. Il formato internazionale elimina quello 0 e aggiunge il prefisso paese, dando +91 seguito dalle dieci cifre.

Salva solo la forma E.164: +91 più dieci cifre, senza spazi, trattini o zero. Normalizza l'input al confine eliminando la formattazione, uno 0 iniziale o un 91 digitato senza il più. Così eviti utenti duplicati che differiscono solo per la formattazione.

La maggior parte degli SMS di verifica in India arriva in inglese e da un'intestazione mittente alfanumerica anziché da un numero di telefono. Alcune app inviano invece in hindi o in un'altra lingua regionale, quindi prova il tuo parser dei codici anche con alfabeti non latini.

Perché i team di prodotto hanno bisogno di un numero +91 per i test?

L'India è un mercato di lancio comune per app consumer, onboarding fintech e marketplace, e i suoi utenti si aspettano un passaggio SMS alla registrazione. I team usano le rotte +91 per provare un lancio, per eseguire il QA di localizzazione su interfacce in hindi, tamil, telugu, bengalese, marathi e altre, per supportare il personale operativo regionale e per verificare i flussi usati dai clienti della diaspora indiana all'estero che accedono ancora con un numero del paese d'origine. Un buon instradamento OTP qui significa scegliere la rotta di servizio che corrisponde al percorso reale dell'utente e poi collegarla alle stesse chiamate dell'API di verifica SMS che usi per gli altri mercati.

Esiste una linea indiana a lungo termine e come funziona la fatturazione?

No. I numeri dedicati sono un prodotto per USA e Canada, a partire da $1.95/month, e dalla dashboard non puoi acquistare una linea indiana a lungo termine. Se ne hai bisogno, scrivi a [email protected]; la disponibilità dipende dalle norme locali e non è garantita.

La fatturazione avviene su un unico wallet prepagato in USD, senza canone mensile e senza un piano da scegliere. Ricarica con carta o con le stablecoin USDT/USDC e ogni ricarica arriva con una fattura PDF via email. Per il lavoro di integrazione, chiedi al supporto di passare in sandbox un account di sviluppo: restituisce numeri e codici simulati, così puoi testare il tuo gestore webhook end to end senza spendere fondi del wallet.

Domande frequenti

Posso testare il flusso di registrazione indiano della mia app senza una SIM locale?

Sì. Ordina un numero +91 tramite l'OTP Gateway, inseriscilo nella tua schermata di registrazione e leggi il codice dalla dashboard, dall'API o dal tuo webhook.

Qual è l'id paese dell'India nell'API di OTP Route?

È in. Passalo come paese in GET /api/v1/prices e nel corpo di POST /api/v1/activations.

Quanto costa ricevere un SMS OTP dell'India?

I codici partono da $0.20 per codice e il prezzo esatto dipende dal servizio. Lo vedi prima di ordinare e un'attivazione che non riceve alcun codice viene rimborsata sul tuo wallet.

Posso riutilizzare lo stesso numero +91 per accedere di nuovo il mese prossimo?

No. Un numero del gateway copre un solo codice di verifica. Gli account che richiedono accessi ripetuti appartengono a una linea dedicata, e queste esistono solo negli USA e in Canada.

Esiste una sandbox per sviluppare l'integrazione con l'India?

Sì, su richiesta. Il supporto può passare un account di sviluppo in sandbox, dove numeri e codici simulati attraversano il tuo codice senza toccare il wallet.

Il nostro team finanziario può pagare con le stablecoin?

Sì. Il wallet accetta pagamenti con carta oltre a USDT e USDC, e ogni ricarica produce una fattura PDF via email.

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.