Italiano
Raccogliere codici di verifica yemeniti (+967) tramite API
Con OTP Route puoi ricevere codici di verifica SMS yemeniti (+967) su un numero monouso dell'OTP Gateway e leggerli nella dashboard, con polling dell'API REST o da un webhook firmato. I prezzi partono da $0.20 per codice, con la tariffa esatta fornita in tempo reale dall'API, e un'attivazione che non riceve alcun SMS entro la sua finestra di 20 minuti viene rimborsata sul tuo wallet.
Qual è il percorso API più breve verso un codice +967?
Punta il tuo client a https://otproute.com/api/v1 con una chiave Bearer dalla console Developer; le chiavi hanno il prefisso or_live_. L'id paese dello Yemen è ye.
- Recupera i prezzi con
GET /api/v1/prices?country=ye&service=<id>; la risposta indica quanto costerà il codice e se la route è aperta. - Crea l'ordine:
POST /api/v1/activationscon{"service": "whatsapp", "country": "ye"}. Ricevi un id di attivazione e il numero +967. - Digita o inietta il numero nel passaggio di verifica della tua app.
- Recupera il codice da
GET /api/v1/activations/{id}o da un evento webhook. - Rilascia un ordine incompleto con
POST /api/v1/activations/{id}/cancel.
GET /api/v1/services e GET /api/v1/countries cambiano raramente, quindi mettili in cache per la giornata. Chiamare GET /api/v1/balance prima di un batch permette al job di fermarsi in anticipo quando i fondi scarseggiano. Il limite di 300 richieste al minuto si applica per account e si possono emettere fino a 10 chiavi. Consulta la guida all'integrazione per un esempio completo di questo flusso dell'API OTP per lo Yemen.
Come verifico le consegne webhook per le attivazioni yemenite?
Registra un endpoint HTTPS nella console Developer (un account può averne cinque) e iscriviti a activation.sms_received, più activation.expired e activation.cancelled, così il tuo job sa quando smettere di aspettare.
I controlli della firma seguono un'unica ricetta. Dividi X-OTPRoute-Signature in t e v1, calcola l'HMAC-SHA256 della stringa <t>.<raw body> usando il secret dell'endpoint e confronta il risultato con v1 tramite una funzione a tempo costante. Rifiuta la richiesta se il timestamp è più vecchio della tua tolleranza. Poiché una consegna può essere ripetuta, rendi il gestore idempotente: salva l'id dell'attivazione e ignora i duplicati. Proteggere i webhook OTP con HMAC tratta casi limite come la deriva dell'orologio.
Cosa deve aspettarsi il mio parser dai messaggi in arabo?
L'arabo è la lingua ufficiale dello Yemen, quindi molti servizi inviano il testo circostante in arabo. Questo ha conseguenze pratiche per chi testa i propri messaggi: la scrittura araba richiede la codifica UCS-2, che limita un segmento SMS a 70 caratteri, e il testo da destra a sinistra può spostare la posizione del codice in una notifica. Alcuni template mettono le cifre prima della frase, altri dopo.
Scrivi il passaggio di estrazione in modo che trovi la sequenza di cifre qualunque sia il testo attorno. È anche sensato normalizzare le cifre indo-arabe (da ٠ a ٩) in cifre ASCII, nel caso un mittente le usi. I team eseguono questi controlli quando localizzano un'app per chi parla arabo, supportano clienti yemeniti che vivono nel Golfo o verificano che un account di supporto regionale si verifichi ancora. OTP Route restituisce il messaggio così come è stato ricevuto, quindi ciò che analizzi in un test è ciò che riceverebbe un utente.
Come sono formattati i numeri di telefono yemeniti?
Il prefisso del paese è +967. I numeri mobili hanno nove cifre dopo di esso e iniziano con 7, secondo lo schema +967 7XX XXX XXX. Se un utente inserisce uno 0 nazionale davanti, eliminalo prima di salvare e conserva la stringa E.164 senza separatori; la formattazione locale appartiene solo all'interfaccia.
Casi di validazione utili per un numero +967 per i test:
- L'utente sceglie +967 dall'elenco dei paesi e poi digita di nuovo il numero completo compreso il prefisso.
- Un numero viene incollato con cifre indo-arabe copiate da una scheda contatto.
- Compaiono spazi o trattini tra i gruppi di cifre.
Ognuno di questi deve finire nello stesso valore salvato, il che mantiene affidabili ricerche e deduplicazione.
Quali servizi arrivano attualmente ai numeri +967?
Lo Yemen ha più di 1.700 servizi sull'OTP Gateway. Tra le voci usate più di frequente nell'istantanea in tempo reale ci sono WhatsApp, Telegram, imo, Facebook, Instagram, TikTok, Snapchat, Google (Gmail & YouTube), X (Twitter), Microsoft & Outlook, Signal, Discord e Amazon.
La disponibilità è un bersaglio mobile, quindi costruisci le suite in modo che interroghino prima l'API. Chi non è nell'ingegneria può fare lo stesso lavoro dalla dashboard: apri un account con un codice via email o l'accesso con Google, ricarica, scegli lo Yemen e il servizio, poi copia il numero di verifica yemenita nell'app e attendi il codice nella pagina dell'attivazione.
Perché un codice yemenita potrebbe non arrivare e come si risolve?
Ogni ordine dura 20 minuti. Se non arriva alcun SMS, o se annulli prima che arrivi, l'intero importo torna automaticamente sul tuo wallet; ti vengono fatturati solo i codici che arrivano.
Cause tipiche e risposte:
- Il servizio è lento in quel momento: lascia scorrere la finestra prima di rinunciare.
- Il servizio rifiuta i numeri virtuali: controlla la sua policy; il rimborso gestisce il tentativo fallito.
- La route è occupata: riprova più tardi o con un'altra route di servizio.
- Uno script rifà l'ordine appena fallisce: aggiungi un backoff per non martellare la route.
Usa questi numeri solo per i tuoi prodotti e account legittimi, rispetta i termini di ciascun servizio e resta entro l'Acceptable Use Policy di OTP Route.
Posso tenere a lungo un numero yemenita e come viene fatturato?
Non in self-service. I Dedicated Virtual Numbers sono offerti solo negli Stati Uniti e in Canada, acquistabili subito da $1.95/mese. I team che hanno bisogno di una linea +967 duratura possono scrivere a [email protected]; se sia possibile fornirne una dipende dalle norme locali e non è mai certo.
Il wallet di OTP Route è prepagato in USD, senza abbonamento né piano. Lo ricarichi con carta o USDT/USDC e per ogni ricarica viene inviata via email una fattura PDF. Controlla le tariffe aggiornate nella pagina dei prezzi e richiedi la sandbox su un account di sviluppo se vuoi numeri e codici simulati per il lavoro di integrazione.
Domande frequenti
Posso testare un flusso di registrazione in arabo con un numero yemenita e senza SIM locale?
Sì. Ordina un numero dell'OTP Gateway con il paese ye, inseriscilo nella tua app e leggi il messaggio in arabo o in inglese nella dashboard o via webhook.
Qual è il prezzo di un codice di verifica +967?
Parte da $0.20 per codice e varia in base al servizio; GET /api/v1/prices restituisce la cifra in tempo reale. I codici che non arrivano mai vengono rimborsati quando termina la finestra di 20 minuti.
Come estraggo il codice se l'SMS si legge da destra a sinistra?
Cerca la sequenza di cifre anziché un pattern di frase e converti prima le cifre indo-arabe in ASCII. Funziona da qualunque lato del testo si trovi il codice.
Il numero +967 è mio da tenere?
No, un numero dell'OTP Gateway copre una sola verifica. I numeri duraturi sono un prodotto per Stati Uniti e Canada; per lo Yemen scrivi al supporto per chiedere.
Posso integrare senza spendere saldo del wallet?
Sì, richiedi la sandbox su un account di sviluppo. Restituisce numeri e codici simulati, sufficienti per testare polling, webhook e gestione degli errori.
Quale id paese usa l'API per lo Yemen?
È ye. Passalo nelle ricerche dei prezzi e nel corpo JSON di POST /api/v1/activations.
Perché un servizio ha rifiutato il mio numero yemenita?
Alcuni servizi non accettano numeri virtuali. Annulla o lascia scadere l'attivazione e il denaro torna automaticamente sul tuo wallet.
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.