Acces la cont și la proiect
Folosiți un cont API activat, prin HTTPS, de la o adresă IP permisă. Proiectul trebuie să aparțină acelui cont și să nu fie șters. Folosiți identificatorul unic al proiectului din fluxul comenzii de portare, nu identificatorul numeric din baza de date sau un număr de telefon. Aplicați codificarea URL identificatorului proiectului când construiți o cerere.
Cerere
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Răspuns
Exemplu fictiv de răspuns.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response este o listă. Un proiect existent fără numere returnează o listă goală, cu codul API 200 și o valoare pentru status.results egală cu 0. În schimb, proiectele inexistente returnează codul API 404.
Câmpurile numerelor
| Câmp | Semnificație |
|---|---|
| id, number, isocode | Identificatorul numeric al rândului, textul stocat al numărului de telefon și codul țării. Identificatorul rândului nu este identificatorul proiectului. |
| status, status_str | Starea numerică și eticheta sa cunoscută. |
| foc | Valoarea de programare stocată a angajamentului ferm privind comanda. Poate fi goală; componenta de tratare nu o convertește într-un fus orar sau într-un format de marcaj temporal documentat. |
| updated, date_created, date_completed | Valorile stocate pentru actualizare, creare și finalizare. Tratați explicit valorile goale; nu presupuneți formatul ISO8601 și nu deduceți un fus orar din exemplul fictiv. |
| comment | Comentariu stocat destinat clientului. Afișați-l ca text, nu ca HTML executabil. |
Această reprezentare omite câmpul internal_comment rezervat personalului. Aceasta nu înseamnă că interogarea separată, de tip vechi, pentru un singur număr folosește aceeași reprezentare.
Ordine și monitorizare
Interogarea ordonează rezultatele crescător după momentul creării. Pentru rândurile cu același moment al creării nu este garantată nicio ordine suplimentară. Nu există paginare, cursor incremental sau filtru de dată. Citiți lista completă pentru reconcilierea datelor unui proiect și nu considerați numărul său actual de rânduri un catalog permanent.
Interpretarea stării portării
| Valoare | Etichetă |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Păstrați starea numerică și tratați valorile necunoscute. Pentru etichetele necunoscute se folosește valoarea stocată, fără a se garanta o etichetă nouă. O stare de finalizare stocată sau o dată programată nu constituie, în sine, un test al rutării de intrare sau al tuturor serviciilor numărului.
Erori și limite
Verificați atât răspunsul HTTP, cât și status.code/status.msg. Un proiect inexistent, șters sau care nu aparține contului returnează codul API 404, cu un mesaj care indică faptul că proiectul nu a fost găsit. Se aplică și restricțiile de autentificare și de IP sursă. Exemplele nu efectuează nicio cerere reală, iar un răspuns reușit nu dovedește că un operator a acceptat sau a finalizat un transfer.
Efecte
Componenta de tratare verificată doar citește proiectul și rândurile numerelor sale stocate. Răspunsul este un instantaneu, nu o confirmare din partea operatorului sau un test real al serviciului. Nu inițiază o portare, nu modifică rutarea și nu debitează contul.