Codici di verifica +351 via API per i lanci in Portogallo

Quali endpoint tocca una verifica +351?

L'URL di base è https://otproute.com/api/v1 e ogni richiesta porta una chiave Bearer che inizia con or_live_. L'id del Portogallo è pt.

1. GET /api/v1/countries e GET /api/v1/services ti danno gli id; tienili in cache per ogni esecuzione di test.
2. GET /api/v1/prices?country=pt&service=<id> restituisce il prezzo attuale e indica se la route è aperta.
3. POST /api/v1/activations con {"service": "telegram", "country": "pt"} riserva il numero e restituisce un id di attivazione.
4. GET /api/v1/activations/{id} riporta lo stato e il codice, se preferisci il polling.
5. POST /api/v1/activations/{id}/cancel libera un numero che il tuo test non usa più.
6. GET /api/v1/balance permette a una pipeline di fermarsi subito quando il wallet è scarico.

I limiti dell'account sono 10 chiavi API, 5 endpoint webhook e 300 richieste al minuto. Gli schemi completi sono nel riferimento API.

Come consegnano i webhook firmati i codici portoghesi al nostro servizio?

Registra un endpoint HTTPS nella console per sviluppatori e iscriviti a activation.sms_received, activation.expired e activation.cancelled. Ogni POST include X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Per verificarla, ricostruisci la stringa <t>.<raw body>, calcola l'HMAC-SHA256 con il secret dell'endpoint e confrontalo con v1 usando un confronto a tempo costante. Rifiuta le richieste con un timestamp troppo vecchio, così una richiesta intercettata non può essere riprodotta. Salva l'id di attivazione di ogni evento e ignora i duplicati: il gestore resta sicuro anche quando le consegne vengono ritentate. Lo schema è spiegato passo per passo in cattura OTP basata su webhook.

Quali servizi sono aperti sulle route portoghesi?

Nello snapshot attuale il Portogallo conta più di 2.000 servizi. Tra quelli usati più spesso ci sono WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord e Signal.

L'elenco cambia nel corso della giornata, perché i nostri partner carrier spostano la capacità. Per questo deve essere l'endpoint dei prezzi, e non un file di configurazione statico, a decidere se un test parte.

Perché i team di prodotto testano con numeri portoghesi?

Il Portogallo compare spesso nelle prime fasi di un piano di rollout nell'UE. Lisbona e Porto ospitano molti team di prodotto e ingegneria, e parecchie aziende usano il Portogallo come base europea. C'è anche un motivo di localizzazione: il portoghese europeo (pt-PT) differisce da quello brasiliano per ortografia, lessico e forme di cortesia, quindi un flusso tradotto per il Brasile può suonare strano a chi vive in Portogallo. Eseguire una vera verifica +351 permette ai revisori di vedere insieme il testo pt-PT, l'SMS in arrivo e le schermate collegate.

Con il GDPR, tenere i numeri di telefono del personale fuori dagli account di test e condivisi è anche una buona pratica di minimizzazione dei dati. Un numero monouso per ogni verifica significa meno identificativi personali nei tuoi sistemi di QA. La guida alle pipeline CI mostra come inserire questo passaggio in ogni build.

Come si formattano e si salvano i numeri +351?

Il Portogallo non ha prefisso interurbano: i numeri hanno nove cifre e si compongono allo stesso modo in ambito nazionale e in forma internazionale dopo +351. I cellulari iniziano con 9, mentre le linee fisse geografiche iniziano con 2. Salvali in formato E.164, rifiuta tutto ciò che non ha nove cifre dopo il prefisso internazionale e rimuovi gli spazi che gli utenti inseriscono quando digitano a gruppi di tre.

I codici in arrivo di solito sono in portoghese o in inglese, a seconda del mittente e della lingua impostata per l'account. Il tuo estrattore di codici dovrebbe cercare le cifre, non una frase fissa.

Un collega può farlo senza codice, e se l'SMS non arriva?

Nella dashboard apri l'OTP Gateway, scegli il Portogallo e un servizio, controlla il prezzo aggiornato e ordina. Incolla il numero nella tua app e attendi il codice nella pagina dell'attivazione.

La finestra dura 20 minuti e paghi solo se il codice arriva; altrimenti l'intero importo torna automaticamente nel wallet. Quando un codice manca:

• Lascia terminare la finestra invece di annullare dopo pochi secondi.
• Verifica che il servizio accetti numeri virtuali in quel flusso.
• Riprova più tardi, oppure testa la stessa schermata con un'altra route di servizio.
• Aspetta tra un tentativo e l'altro invece di rifare ordini a raffica.

Esiste una linea portoghese dedicata e come funziona la fatturazione?

OTP Route non vende numeri dedicati in self-service in Portogallo. I Numeri Virtuali Dedicati esistono solo per Stati Uniti e Canada, da $1.95/month; per una linea +351 di lungo periodo scrivi a [email protected], tenendo presente che la disponibilità dipende dalle norme locali e non è garantita. Leggi le differenze tra numeri temporanei e dedicati.

Il pagamento è a consumo da un wallet prepagato in USD, senza canoni mensili né piani, ricaricabile con carta o con USDT/USDC; ogni ricarica è accompagnata da una fattura PDF. Gli account di sviluppo possono essere passati alla sandbox su richiesta per testare con numeri e codici simulati. Rispetta i termini di ogni servizio; si applica la Acceptable Use Policy di OTP Route.

Domande frequenti

Qual è l'id del Portogallo per l'API di OTP Route?

È pt, da usare sia nella query dei prezzi sia nel corpo della richiesta di attivazione.

I numeri di telefono portoghesi usano un prefisso interurbano, come uno 0 iniziale?

No. I numeri portoghesi hanno nove cifre e nessun prefisso interurbano, quindi la forma E.164 è +351 seguito da quelle nove cifre.

Posso testare un flusso di onboarding pt-PT senza una SIM portoghese?

Sì. Un numero +351 per i test dell'OTP Gateway riceve il codice, che leggi nella dashboard o tramite l'API.

Quanto costa un numero di verifica del Portogallo?

Da $0.20 per codice; il prezzo preciso dipende dal servizio e viene mostrato prima dell'ordine.

Pagherò per un'attivazione +351 che non riceve nulla?

No. Le attivazioni scadute o annullate vengono rimborsate per intero nel tuo wallet.

Posso noleggiare un numero portoghese per accessi ripetuti?

Non in self-service. Le linee di lungo periodo sono un prodotto per Stati Uniti e Canada; scrivi al supporto se ti serve una linea +351.

Per i codici portoghesi devo usare il polling o i webhook?

I webhook scalano meglio per i job paralleli, mentre il polling di GET /api/v1/activations/{id} si adatta ai runner che non possono ricevere traffico in ingresso.

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.