Instradare gli OTP albanesi (+355) nella tua pipeline di test

Quali chiamate REST restituiscono un numero albanese e il suo codice?

L'API OTP per l'Albania è la stessa API di verifica SMS usata per ogni mercato; cambia solo l'id del paese. Le richieste vanno a https://otproute.com/api/v1 con una chiave Bearer con prefisso or_live_, generata nella Developer console. L'id dell'Albania è al, quindi un'esecuzione tipica è questa:

1. GET /api/v1/services ricava l'id del servizio che ti serve, ad esempio telegram o google. Metti l'elenco in cache tra un'esecuzione e l'altra.
2. GET /api/v1/prices?country=al&service=<id> legge il prezzo aggiornato e conferma che la route è aperta in questo momento.
3. POST /api/v1/activations con {"service": "telegram", "country": "al"} restituisce un id di attivazione e un numero +355.
4. Il tuo test invia quel numero nella schermata di registrazione o di accesso dell'app in prova.
5. Il codice arriva tramite webhook o facendo polling su GET /api/v1/activations/{id}; chiama POST /api/v1/activations/{id}/cancel se il test viene interrotto.

Un account può avere fino a 10 chiavi, quindi staging, CI e il portatile di un collega possono averne ciascuno una propria e revocarla separatamente. Il limite di 300 richieste al minuto lascia spazio a più suite in parallelo. I dettagli sui campi sono nel riferimento API.

I miei test sull'Albania devono fare polling o ascoltare i webhook?

Il polling è la cosa più rapida da configurare: interroga l'endpoint dell'attivazione ogni pochi secondi finché lo stato cambia. Quando le suite girano in parallelo, un webhook è più ordinato. Registra fino a 5 endpoint e iscriviti a activation.sms_received, activation.expired e activation.cancelled.

Ogni consegna è firmata. L'intestazione X-OTPRoute-Signature ha la forma t=<unix>,v1=<hex>, dove v1 è l'HMAC-SHA256 di "<t>.<raw body>" calcolato con il segreto dell'endpoint. Ricalcolalo sui byte originali della richiesta, confronta in tempo costante e scarta tutto ciò che porta un timestamp scaduto. Considera gli eventi con l'id di attivazione come chiave, così una consegna ripetuta non scrive mai due volte. Il nostro articolo sulla cattura OTP basata su webhook illustra un gestore completo.

Come vanno normalizzati i numeri +355 prima di arrivare al database?

L'Albania usa il prefisso internazionale +355 e un prefisso nazionale di rete 0. Localmente un numero di cellulare si scrive di solito con quello 0 davanti, come 06X XXX XXXX, mentre la forma internazionale lo elimina: +355 6X XXX XXXX. Salva la versione E.164 (+3556…, senza spazi) e applica la formattazione locale solo al momento della visualizzazione.

Controlli utili quando convalidi un numero +355 per i test:

• Rimuovi lo 0 iniziale quando un utente digita la forma nazionale dopo aver già selezionato +355.
• Rifiuta un prefisso doppio come +355 0 6X, che compare quando un modulo incolla alla cieca il prefisso del paese davanti al numero locale.
• Tieni spazi, trattini e parentesi fuori dal valore salvato.

La formulazione attorno al codice dipende dal servizio mittente e dalla lingua impostata sull'account; albanese e inglese sono entrambi comuni. Punta sulle cifre nel tuo parser, non su una frase fissa. I team testano questo mercato quando lanciano in Albania, localizzano un'app per chi parla albanese nella regione e all'estero, o verificano che un account operativo regionale si verifichi ancora.

Cosa posso verificare sulla route Albania?

La route Albania elenca attualmente più di 1.500 servizi. Tra le voci popolari dell'istantanea live ci sono WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, Signal, Microsoft & Outlook, ChatGPT (OpenAI), Uber, LinkedIn e Discord.

L'inventario cambia durante il giorno, ed è per questo che la disponibilità arriva dall'API e non da un elenco statico. Condiziona ogni test a una consultazione del prezzo per al e segnalalo come saltato, non fallito, quando la route è chiusa. Così il rumore del routing OTP resta fuori dai tuoi veri risultati di regressione.

Un collega non tecnico può ordinare un numero +355?

Sì. La dashboard copre lo stesso flusso senza scrivere codice:

1. Registrati con la tua email e un codice email a 6 cifre o con l'accesso Google, poi attiva l'autenticazione a due fattori TOTP.
2. Aggiungi fondi al portafoglio con carta o con USDT/USDC.
3. Scegli Albania e il servizio, controlla il prezzo mostrato e conferma l'ordine.
4. Digita il numero di verifica albanese nell'app; il codice compare nella pagina dell'attivazione quando arriva l'SMS.

Le agenzie che gestiscono profili di clienti e il personale operativo che configura account aziendali regionali tendono a usare questa strada. Gli ordini fatti qui e tramite l'API condividono lo stesso portafoglio e la stessa regola di rimborso.

E se l'SMS albanese non arriva?

Un'attivazione resta aperta per 20 minuti. Paghi solo se il codice arriva; se la finestra si chiude vuota o annulli in anticipo, l'intero importo torna da solo nel portafoglio e il webhook invia activation.expired o activation.cancelled.

Quando manca un codice:

• Concedi tempo alla finestra prima di reagire, perché alcuni servizi inviano lentamente.
• Verifica se il servizio accetta numeri virtuali; alcuni li rifiutano per policy.
• Riprova più tardi, o con una route di un altro servizio se il test lo consente.
• Evita di riordinare in un ciclo serrato. Lascia un intervallo tra i tentativi per non martellare la route con uno script.

Il nostro approfondimento sulla riduzione delle consegne OTP fallite elenca altri schemi di ripetizione per le route balcaniche e non solo. Usa questi numeri solo per i tuoi prodotti e account, rispetta i termini di ogni servizio e ricorda che vale l'Acceptable Use Policy di OTP Route.

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

Per l'Albania non esiste un numero a lungo termine in self-service. I numeri virtuali dedicati si vendono all'istante solo negli Stati Uniti e in Canada, da $1.95/mese, con SMS in entrata, inoltro via webhook, SMS in uscita e chiamate dal browser. Se ti serve una linea albanese duratura, scrivi a [email protected]; la possibilità di realizzarla dipende dalle norme locali e non è garantita.

La fatturazione passa da un unico portafoglio USD prepagato, senza canone mensile e senza piani da scegliere. Ricarica con carta o con USDT/USDC, e ogni ricarica arriva con una fattura PDF via email. I prezzi aggiornati sono nella pagina dei prezzi. Per il lavoro di integrazione, chiedi di passare un account di sviluppo in sandbox, che restituisce numeri e codici simulati così la pipeline può essere provata senza spendere fondi del portafoglio.

Domande frequenti

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

Sì. Ordina un numero OTP Gateway con paese al, inseriscilo nella schermata di registrazione e leggi il codice nella dashboard o dal tuo webhook. Non servono SIM né contratti con operatori locali.

Quanto costa un codice di verifica albanese?

I codici partono da $0.20 e il prezzo esatto per un dato servizio viene restituito da GET /api/v1/prices prima dell'ordine. Se nulla arriva entro la finestra di 20 minuti, l'addebito torna nel tuo portafoglio.

Devo salvare i numeri albanesi con lo 0 iniziale?

No. Salvali in E.164, cioè +355 seguito dal numero nazionale senza lo 0 del prefisso di rete, e riaggiungi lo 0 solo per la visualizzazione locale.

Lo stesso numero +355 può essere riutilizzato per un login successivo?

Un numero OTP Gateway serve un solo codice di verifica. Per gli account che devono continuare ad accedere, usa un numero dedicato negli Stati Uniti o in Canada, oppure chiedi al supporto per l'Albania.

OTP Route ha una sandbox per i test di integrazione sull'Albania?

La modalità sandbox può essere attivata su richiesta per un account di sviluppo. Restituisce numeri e codici simulati, così le esecuzioni CI provano l'intero flusso senza toccare i fondi del portafoglio.

Perché la mia app ha rifiutato il numero albanese?

Alcuni servizi rifiutano i numeri virtuali. Annulla l'attivazione o lasciala scadere per ottenere il rimborso automatico, poi riprova in un altro momento o tramite un'altra route.

Quale id API uso per l'Albania?

Usa al come valore country nelle consultazioni dei prezzi e nelle richieste di attivazione, e prendi l'id del servizio da GET /api/v1/services.

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.