SMS OTP
Invia un codice via SMS. Verificalo per destinatario.
La verifica via SMS invia un codice monouso a un numero di telefono e conferma che la persona che lo digita è effettivamente in possesso di quel numero. Bird genera il codice, lo invia, applica limiti per destinatario e lo verifica in base al destinatario: nessun id da memorizzare, nessun endpoint di reinvio da configurare.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({
apiKey: process.env.BIRD_API_KEY!,
});
// Send the code, then check it by recipient.
await bird.verify.verifications.create({
to: { phone_number: "+15551234567" },
}).safe();
const { data, error } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();
if (error) throw error;
Your account
Confirm it’s you.
Enter the code sent to
+1 ••• ••• 4567Example verification code
Scelto ogni giorno dai team che creano software di livello mondiale
Leggi altre storie dei clientiSMS OTP è una chiamata per inviare e una per verificare.
SMS è un canale della famiglia telefonica sulla Bird Verify API: inviate una verifica con un numero di telefono e noi inviamo il codice tramite un mittente condiviso gestito da Bird, Bird Verify per impostazione predefinita o Authifly se preferite; verificatelo con lo stesso numero. Reinviare la richiesta di creazione equivale al reinvio (create-or-retry), e ogni codice nella sessione resta valido finché non viene verificato, scade o esaurisce i tentativi.
Cosa ottenete con una verifica SMS.
Integrato, a ogni invio.
- 01
Indirizzato per numero di telefono.
Passate un singolo numero di telefono E.164. Lo normalizziamo e lo inviamo via SMS tramite il mittente associato al Paese di destinazione.
- 02
Codici generati dal server e sottoposti a hash.
A 6-digit code by default (4–8 configurable), generated with a cryptographic random source and stored only as an HMAC. You never see the plaintext.
- 03
Il reinvio è la stessa chiamata.
Ripeti la chiamata di creazione per reinviare il codice una volta trascorso il cooldown di 60 secondi: stessa sessione, nuovo codice, entrambi ancora validi. Nessun endpoint di reinvio separato.
- 04
Limiti per destinatario inclusi.
Un limite di invio per destinatario regola il volume di invio e la spesa fuori controllo, con un 429 e Retry-After.
- 05
Copertura che si espande per Paese.
SMS viene attualmente inviato tramite un mittente condiviso gestito da Bird, Bird Verify o Authifly, mostrando un sender ID brandizzato dove il Paese lo consente e un short code o numero locale dove richiesto, con mittenti dedicati e registrati che estendono la copertura man mano che diventano disponibili.
L'intero flusso, due chiamate.
Create-or-retry invia il codice al numero di telefono; check lo conferma tramite quel numero. Non c'è nessun id da collegare tra le due chiamate: il destinatario è la chiave.
await bird.verify.verifications.create({
to: { phone_number: "+15551234567" },
}).safe();
const { data, error } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();
if (error) throw error;
// data.success is true or false; data.reason elaborates ("incorrect_code", "expired", "attempts_exhausted")Mettilo in pratica.
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Il resto della piattaforma Verify
Una API, un set di chiavi. Esplorate le altre funzionalità.
L'API di verifica senza nulla da salvare.
SMS è un canale di Bird Verify: email e WhatsApp sono inclusi, e il canale voce è in fase di rilascio — tutto sugli stessi due endpoint.