Vérification par SMS en Node.js
Un module ES complet qui utilise le fetch intégré de Node.js 18+ : il achète un numéro temporaire, attend le code et clôture la commande, avec les types TypeScript de la réponse.
Comment recevoir un code de vérification par SMS en Node.js ?
Appelez fetch avec l’en-tête X-Api-Key : POST /v1/orders pour obtenir le numéro, interrogez GET /v1/orders/{id} toutes les 4 secondes jusqu’à ce que messages contienne le SMS, lisez messages.at(-1).code puis appelez POST finish. Annulez si rien n’arrive pour libérer le montant réservé.
Préparation
- Node.js 18 ou plus récent (fetch intégré et await de premier niveau dans les fichiers .mjs).
- Aucune dépendance à installer.
- Exportez la clé : export SMSNITRO_API_KEY=...
Script complet
// Node.js 18+ (global fetch). Save as activation.mjs and run: node activation.mjs
const API = "https://smsnitro.com/api/v1";
const headers = { "X-Api-Key": process.env.SMSNITRO_API_KEY, "Content-Type": "application/json" };
async function api(method, path, body) {
const res = await fetch(API + path, { method, headers, body: body && JSON.stringify(body) });
const data = await res.json();
if (!res.ok) throw new Error(`${res.status}: ${data.detail}`);
return data;
}
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
const { balance } = await api("GET", "/balance");
console.log("Balance:", balance, "USD");
let order = await api("POST", "/orders", { product: "telegram", country: "usa" });
console.log("Number:", order.phone, "order", order.id);
const deadline = Date.now() + 600_000; // numbers stay reserved for up to 20 minutes
let done = false;
while (!done && Date.now() < deadline) {
order = await api("GET", `/orders/${order.id}`);
if (order.messages.length) {
console.log("Code:", order.messages.at(-1).code);
await api("POST", `/orders/${order.id}/finish`);
done = true;
} else if (["CANCELED", "TIMEOUT", "BANNED", "FINISHED"].includes(order.status)) {
console.log("Ended without SMS:", order.status, "(not charged)");
done = true;
} else {
await sleep(4000); // poll every 3 to 5 seconds
}
}
if (!done) {
await api("POST", `/orders/${order.id}/cancel`); // refund the frozen amount
console.log("No SMS: cancelled and refunded");
}Types TypeScript
L’objet commande renvoyé par tous les endpoints de commande. Les prix arrivent en chaîne décimale : convertissez-les avec Number() uniquement pour l’affichage.
type Sms = { sender: string; text: string; code: string; received_at: string };
type Order = {
id: number;
phone: string;
status: "PENDING" | "RECEIVED" | "FINISHED" | "CANCELED" | "TIMEOUT" | "BANNED";
price: string; // decimal string, USD
expires: string | null; // ISO 8601, UTC
messages: Sms[];
awaiting_resend: boolean;
server: number;
};