Căutați informații de rutare

Solicitați informații de rutare pentru un număr de telefon din America de Nord. Folosiți-le pentru a interpreta datele disponibile despre rutare și operator, nu ca dovadă a identității abonatului, a deținerii numărului, a posibilității de a-l contacta sau a disponibilității numărului pentru cumpărare. O interogare poate genera o taxă în contul dumneavoastră.

Cerere

Folosiți contul dumneavoastră API activat și adresa IP sursă permisă pentru acesta. Furnizați numărul complet, numai cu cifre, inclusiv codul de țară 1. Exemplul folosește variabile de mediu și un număr fictiv. Componenta de procesare nu normalizează semnele de punctuație; validați datele de intrare înainte de trimitere.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/lrn/12025550123

Răspuns

Sunt prezentate doar câteva câmpuri selectate, cu titlu ilustrativ; disponibilitatea lor depinde de sursă și de tipul numărului.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

Interogarea standard convertește în litere mici numele câmpurilor returnate. În funcție de sursă, pot fi prezente câmpuri pentru operator, centrul de tarifare, localizare și jurisdicție. Răspunsul nu reprezintă o înregistrare completă a abonatului cu structură fixă. Indicatorul local poate avea valoarea numerică 1 sau valoarea 0 sub formă de șir de caractere. Componenta de procesare calculează ported comparând numărul de rutare returnat cu numărul de telefon furnizat; nu interpretați această valoare ca pe un istoric complet și verificat al portărilor.

Preț și reîncercări

Componenta de procesare analizată debitează contul cu $0.00025 atunci când ajunge pe calea de finalizare și înregistrează interogarea. Costul returnat este de obicei un șir de caractere care include simbolul dolarului, nu doar o valoare numerică. Nu este expusă nicio cheie de idempotență. Repetarea unei cereri poate genera o nouă taxă.

Pentru conturile preplătite, codul verifică dacă soldul este de cel puțin 0.00025. Mesajul de sold insuficient menționează în prezent $5, sumă care nu corespunde acestui prag. Interpretați eroarea ca pe o respingere din cauza soldului și verificați fondurile din cont înainte de a reîncerca.

Erori și reușite incomplete

Consultați atât starea HTTP, cât și status.code/status.msg din JSON. Un rezultat gol al interogării standard returnează codul API 404. Codul API 403 poate indica un sold preplătit insuficient.

O cale actuală de tratare a erorilor pentru numerele cu apelare gratuită poate totuși debita suma aferentă interogării și raporta codul API 200 fără câmpuri de rutare utile; informațiile despre cost pot fi incomplete. Prin urmare, simpla prezență a codului 200 nu confirmă că interogarea este utilizabilă. Validați câmpurile necesare aplicației dumneavoastră, confruntați taxele incerte cu evidențele de facturare ale contului și contactați serviciul de asistență pentru rezultate incomplete.

În implementarea analizată, procesarea numerelor cu apelare gratuită diferă în funcție de lungimea datelor de intrare. Folosiți de preferință toate cifrele numărului în format internațional și confirmați cu serviciul de asistență acoperirea necesară pentru numerele cu apelare gratuită. Nu repetați automat o interogare care a produs un rezultat incorect formatat sau incomplet și nu vă bazați pe o interogare de rutare pentru a decide că apelarea unui număr este sigură sau autorizată.