API OTP per il Qatar: webhook, polling e numeri di test +974

Che aspetto ha la sequenza di chiamate dell'API OTP per il Qatar?

Tutto si trova sotto https://otproute.com/api/v1, con autenticazione tramite una chiave Bearer che inizia con or_live_. Puoi avere fino a 10 chiavi, quindi assegna chiavi separate a CI, staging e script operativo e revoca una senza toccare le altre. Un'attivazione +974 completa richiede al massimo quattro chiamate:

1. GET /api/v1/prices?country=qa&service=<id> restituisce il prezzo aggiornato e ti dice che la route è aperta per quel servizio in questo momento.
2. POST /api/v1/activations con {"service": "<id>", "country": "qa"} riserva un numero del Qatar e restituisce un id di attivazione.
3. GET /api/v1/activations/{id} è la chiamata di polling: mostra a che punto è l'ordine per il Qatar e include il codice dopo la consegna.
4. POST /api/v1/activations/{id}/cancel chiude l'ordine in anticipo e riporta l'importo nel wallet.

Due chiamate di supporto completano il quadro: GET /api/v1/services associa i nomi agli id dei servizi e GET /api/v1/balance permette a una pipeline di fermarsi prima di restare a secco. Mantieni il traffico sotto le 300 richieste al minuto per account. La panoramica per sviluppatori raccoglie le pagine di riferimento.

Come deve trattare un gestore webhook gli eventi di attivazione per il Qatar?

Il polling funziona, ma un webhook permette al tuo test runner di reagire nel momento in cui succede qualcosa. Registra fino a cinque endpoint e iscriviti a activation.sms_received, activation.expired e activation.cancelled; il primo porta il codice, gli altri due dicono al runner di smettere di aspettare.

Ogni richiesta include X-OTPRoute-Signature nella forma t=<unix>,v1=<hex>. Ricostruisci la stringa firmata come timestamp, un punto e il corpo grezzo della richiesta, calcola l'HMAC-SHA256 con il secret dell'endpoint e confrontalo a tempo costante. Rifiuta tutto ciò che ha un timestamp scaduto. Poiché i nuovi tentativi possono consegnare lo stesso evento più di una volta, salva l'id di attivazione e ignora i duplicati. Per un'implementazione di riferimento, leggi cattura OTP basata su webhook.

Quali servizi possono instradare un codice verso un numero +974?

Il Qatar è una delle route più ampie, con più di 1.600 servizi nell'ultimo snapshot. Tra le voci più diffuse ci sono WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude e Discord.

L'inventario cambia durante la giornata, quindi considera lo snapshot un orientamento e la risposta dell'API la verità. Alcuni servizi rifiutano i numeri virtuali; quando succede, l'ordine semplicemente scade e il denaro torna indietro. Ogni nome citato sopra è un marchio del rispettivo proprietario, senza alcuna affiliazione implicita.

Normalizzare i numeri del Qatar nelle fixture di test

I numeri del Qatar hanno otto cifre dopo +974 e nessun prefisso interurbano, quindi non c'è nulla da eliminare quando si converte un numero locale in forma internazionale. Mantieni le fixture in E.164 (+974 più otto cifre) e ripulisci gli input digitati dagli utenti con 00974, spazi o uno zero iniziale di troppo portato dalle abitudini di un altro paese.

L'arabo è la lingua ufficiale, mentre l'inglese è molto usato negli affari e da una popolazione con un'ampia quota di espatriati. I messaggi di verifica arrivano quindi nella lingua che il servizio mittente sceglie per l'account, spesso inglese o arabo. Controlla che la tua logica di estrazione trovi il codice in entrambe le scritture e che un'interfaccia in arabo mantenga utilizzabile il campo OTP in un layout da destra a sinistra.

I team testano la route del Qatar quando lanciano un prodotto nel GCC, localizzano un'app consumer per i parlanti arabi, gestiscono operazioni di ospitalità o logistica a Doha, oppure verificano un account aziendale regionale senza usare il numero personale di un dipendente. La guida ai test CI mostra come integrare questi controlli nelle esecuzioni automatiche.

Eseguire invece una verifica per il Qatar dalla dashboard

Non ogni verifica richiede uno script. Nella dashboard apri l'OTP Gateway, seleziona il Qatar e il servizio, controlla il prezzo mostrato e conferma. Copia il numero +974 nell'app, richiedi l'SMS e il codice compare nell'ordine. La finestra di 20 minuti decorre dal momento in cui effettui l'ordine e paghi solo se un codice arriva.

Codici che non arrivano: una lista per il debug

• Hai aspettato abbastanza? Lascia che l'attivazione completi l'intera finestra prima di considerarla fallita.
• I numeri virtuali sono accettati? Alcuni servizi li bloccano e i tentativi ripetuti non cambiano la situazione.
• La politica di retry è sensata? Usa un backoff e riprova più tardi, oppure passa a un'altra route per lo stesso servizio. Rifare ordini a raffica spreca il tuo limite di richieste e di rado aiuta.
• Il gestore è in salute? Se il controllo della firma fallisce o l'endpoint restituisce un errore, fai polling su GET /api/v1/activations/{id} per vedere se il codice è stato consegnato mentre il webhook lo perdeva.

Un'attivazione che termina senza SMS, per scadenza o per annullamento, viene rimborsata per intero.

Esiste una linea qatariota di lungo periodo e come viene fatturato l'uso?

Per il Qatar non esiste alcun numero di lungo periodo in self-service. I Numeri Virtuali Dedicati (una linea tua con SMS in entrata e in uscita, inoltro via webhook e chiamate dal browser) sono offerti solo negli Stati Uniti e in Canada, da $1.95/month. Per un'esigenza specifica sul Qatar scrivi a [email protected]; le norme locali determinano ciò che è possibile.

L'uso per il Qatar attinge a un unico wallet prepagato in USD e nulla viene fatturato mensilmente. Ricarica con carta o USDT/USDC, ricevi una fattura PDF per ogni ricarica e chiedi la modalità sandbox su un account di sviluppo se vuoi testare l'integrazione con numeri e codici simulati. Usa i numeri +974 solo per i tuoi prodotti e per account aziendali legittimi, rispetta i termini di ogni servizio e segui la Acceptable Use Policy di OTP Route.

Domande frequenti

Come ricevo i codici SMS OTP del Qatar in un test automatizzato?

Crea un'attivazione con il paese qa, inserisci il numero restituito nell'app sotto test e attendi il webhook activation.sms_received. OTP Route supporta anche il polling dell'attivazione se il tuo test runner non può accettare richieste in ingresso.

Posso usare un numero +974 per i test senza una SIM del Qatar?

Sì. L'OTP Gateway fornisce un numero di verifica del Qatar per un codice, così puoi testare registrazione o accesso senza alcuna SIM o dispositivo locale.

Come controllo i prezzi per il Qatar prima di ordinare?

Chiama GET /api/v1/prices?country=qa&service=<id> oppure guarda nella dashboard. Le tariffe partono da $0.20 per codice e variano in base al servizio.

Vengo addebitato per le attivazioni del Qatar che falliscono?

No. Paghi solo quando arriva un codice; le attivazioni scadute o annullate vengono rimborsate automaticamente nel wallet.

Perché testare con un numero qatariota e non con uno di un paese vicino?

Scegli il paese che corrisponde al mercato reale dell'account. Se il tuo prodotto viene lanciato in Qatar, un numero +974 mette alla prova la gestione del prefisso, la lingua e l'OTP routing esattamente come li vedranno i tuoi clienti, come spiega instradamento per paese degli OTP.

Un account di sviluppo può funzionare senza fondi nel wallet?

Sì. Su richiesta un account di sviluppo può essere passato alla sandbox, che restituisce numeri e codici simulati per i test end-to-end.

Posso tenere un numero qatariota per accessi ripetuti?

Non in self-service, perché le linee dedicate sono limitate a Stati Uniti e Canada. Scrivi a [email protected] se vuoi informarti su una linea del Qatar di lungo periodo.

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.