Qasja te llogaria dhe projekti
Përdorni një llogari API të aktivizuar përmes HTTPS nga një adresë IP e lejuar. Projekti duhet t’i përkasë asaj llogarie dhe të mos jetë fshirë. Përdorni identifikuesin unik të projektit nga rrjedha e porosisë për bartjen e numrave, jo identifikuesin e tij numerik në bazën e të dhënave ose një numër telefoni. Zbatoni kodimin URL për identifikuesin e projektit kur ndërtoni një kërkesë.
Kërkesa
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Përgjigjja
Shembull i sajuar i përgjigjes.
{
"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 është një listë. Një projekt ekzistues pa numra kthen një listë bosh me kodin API 200 dhe me vlerën e status.results të barabartë me 0. Projektet që nuk ekzistojnë kthejnë, përkundrazi, kodin API 404.
Fushat e numrave
| Fusha | Kuptimi |
|---|---|
| id, number, isocode | Identifikuesi numerik i rreshtit, teksti i ruajtur i numrit të telefonit dhe kodi i shtetit. Identifikuesi i rreshtit nuk është identifikuesi i projektit. |
| status, status_str | Statusi numerik dhe etiketa e tij e njohur. |
| foc | Vlera e ruajtur e planifikimit për zotimin përfundimtar të porosisë. Mund të jetë bosh; trajtuesi nuk e konverton në një zonë kohore ose format vule kohore të dokumentuar. |
| updated, date_created, date_completed | Vlerat e ruajtura të përditësimit, krijimit dhe përfundimit. Trajtojini shprehimisht vlerat bosh; mos supozoni formatin ISO8601 dhe mos nxirrni një zonë kohore nga shembulli i sajuar. |
| comment | Koment i ruajtur i destinuar për klientin. Shfaqeni si tekst, jo si HTML të ekzekutueshëm. |
Kjo paraqitje përjashton fushën internal_comment të rezervuar vetëm për stafin. Kjo nuk do të thotë se kërkimi i veçantë i vjetër për një numër të vetëm përdor të njëjtën paraqitje.
Renditja dhe monitorimi
Kërkimi i rendit rezultatet sipas kohës së krijimit në rend rritës. Për rreshtat me kohë krijimi të njëjta nuk garantohet ndonjë renditje shtesë. Nuk ka ndarje në faqe, kursor rritës ose filtër date. Lexoni listën e plotë për të rakorduar të dhënat e një projekti dhe mos e trajtoni numrin aktual të rreshtave të tij si një katalog të përhershëm.
Interpretimi i statusit të bartjes
| Vlera | Etiketa |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Ruani statusin numerik dhe trajtoni vlerat e panjohura. Për etiketat e panjohura përdoret vlera e ruajtur, pa u garantuar një etiketë e re. Një status i ruajtur përfundimi ose një datë e planifikuar nuk përbën, në vetvete, një provë të drejtimit të thirrjeve hyrëse ose të çdo shërbimi në numër.
Gabimet dhe kufizimet
Kontrolloni si përgjigjen HTTP, ashtu edhe status.code/status.msg. Një projekt që nuk ekziston, është fshirë ose nuk i përket llogarisë kthen kodin API 404 me një mesazh se projekti nuk u gjet. Zbatohen gjithashtu kufizimet e autentikimit dhe të IP-së burimore. Shembujt nuk kryejnë një kërkesë reale dhe një përgjigje e suksesshme nuk provon se një operator e ka pranuar ose përfunduar një transferim.
Efektet
Trajtuesi i shqyrtuar vetëm lexon projektin dhe rreshtat e numrave të tij të ruajtur. Përgjigjja është një pamje e çastit, jo një konfirmim i operatorit ose një provë e drejtpërdrejtë e shërbimit. Ajo nuk nis bartje numri, nuk ndryshon drejtimin e thirrjeve dhe nuk debiton llogarinë.