API pentru primirea SMS: coduri de verificare pe numere care îți aparțin

BusySMS comparat cu serviciile de numere virtuale

Când folosești fiecare variantă

Dacă ai nevoie de un număr de unică folosință pentru un test izolat și nimic nu va depinde de el, un număr virtual este calea mai rapidă, iar BusySMS nu este instrumentul potrivit. Dacă acel cont contează, de exemplu autentificarea de administrator a companiei tale, un cont de test în care CI-ul tău se autentifică în fiecare noapte sau numărul pe care clienții tăi îl cunosc deja, primește pe un număr care îți aparține.

BusySMS nu este nici o cale de a ocoli verificarea altcuiva. Citește coduri trimise pe numere pe care le controlezi, pentru conturi care îți aparțin. Nu poate citi mesajele altor persoane și nu este făcut pentru crearea de conturi în masă.

Cum funcționează primirea cu BusySMS

1. 1

   Pune receptorul pe telefon

   Pe Android, aplicația BusySMS din Google Play. Pe iPhone, o automatizare din Comenzi rapide, cu sau fără aplicația BusySMS pentru iPhone.

2. 2

   Verifică numărul

   BusySMS trimite un cod prin SMS pe număr, iar telefonul îl transmite înapoi. Asta dovedește că SIM-ul are numărul; până atunci nimic nu este stocat sau facturat.

3. 3

   Primește

   Sunt păstrate doar mesajele care arată ca niște coduri de verificare. Fiecare este etichetat cu numărul care l-a primit, expeditorul, serviciul detectat și ora la care a sosit.

4. 4

   Citește

   Programul tău apelează API REST, un agent AI folosește MCP, iar o persoană vede codul în panou sau lasă extensia Chrome să-l introducă.

Pe ce numere poți primi

• Orice număr de pe un SIM dintr-un telefon care îți aparține: un telefon cu Android 8.0 sau mai nou și aplicația BusySMS, ori un iPhone cu iOS 14 sau mai nou, prin Comenzi rapide.
• Fiecare SIM dintr-un telefon dual-SIM este un număr separat, verificat și facturat separat.
• Numerele sunt verificate printr-un SMS dus-întors, așa că nu poți adăuga un număr al cărui SIM nu îl ai.

Primește un cod prin API

Creează o cheie în panou, la API REST, și păstreaz-o într-o variabilă de mediu. Apoi așteaptă următorul cod pe un anumit număr:

# Digits only: the receiving number +44 7700 900123
curl -s -H "Authorization: Bearer $BUSYSMS_API_KEY" \
  "https://busysms.net/api/v1/codes?phone=447700900123&timeoutMs=60000"

const params = new URLSearchParams({ phone: "447700900123", timeoutMs: "60000" });
const res = await fetch(`https://busysms.net/api/v1/codes?${params}`, {
  headers: { Authorization: `Bearer ${process.env.BUSYSMS_API_KEY}` },
});
if (!res.ok) throw new Error(`BusySMS ${res.status}`);

const { code } = await res.json(); // null if nothing new arrived
console.log(code);

import os
import requests

r = requests.get(
    "https://busysms.net/api/v1/codes",
    params={"phone": "447700900123", "timeoutMs": 60000},
    headers={"Authorization": f"Bearer {os.environ['BUSYSMS_API_KEY']}"},
    timeout=75,
)
r.raise_for_status()
print(r.json()["code"])  # None if nothing new arrived

phone se potrivește cu numărul care primește (cifrele sunt suficiente), așa că, având mai multe numere în cont, primești codul pentru numărul corect. Așteptarea durează până la 90 de secunde și returnează null, nu un cod mai vechi, dacă nu sosește nimic nou.

Ca să citești istoricul în loc să aștepți, listează mesajele recente ale unui telefon cu GET /api/v1/devices/:id/messages; mesajele capturate sunt păstrate cel mult 7 zile. Toate endpointurile și erorile sunt în ghidul despre API-ul de gateway SMS.

Ce se primește și ce nu

• La configurare alegi, pentru fiecare SIM Android: toate SMS-urile sau doar mesajele de tip verificare. Celelalte mesaje le poți vedea doar tu.
• Pe un iPhone, verificarea se face chiar pe telefon: un mesaj care nu arată ca un cod nu pleacă niciodată de pe el.
• Nimic nu este capturat cât timp gateway-ul este oprit.
• Un număr trebuie să treacă verificarea înainte ca ceva din ce primește să fie stocat.

Întrebări

Întrebări frecvente