Prieiga prie paskyros ir projekto
Naudokite įjungtą API paskyrą per HTTPS iš leidžiamo IP adreso. Projektas turi priklausyti tai paskyrai ir negali būti ištrintas. Naudokite unikalų projekto identifikatorių iš numerių perkėlimo užsakymo eigos, o ne jo skaitinį duomenų bazės identifikatorių ar telefono numerį. Kurdami užklausą, projekto identifikatoriui taikykite URL kodavimą.
Užklausa
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Atsakymas
Išgalvotas atsakymo pavyzdys.
{
"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 yra sąrašas. Esamas projektas, kuriame nėra numerių, grąžina tuščią sąrašą su API kodu 200 ir status.results reikšme, lygia 0. Neegzistuojantys projektai grąžina API kodą 404.
Numerių laukai
| Laukas | Reikšmė |
|---|---|
| id, number, isocode | Skaitinis eilutės identifikatorius, išsaugotas telefono numerio tekstas ir šalies kodas. Eilutės identifikatorius nėra projekto identifikatorius. |
| status, status_str | Skaitinė būsena ir jos žinoma žyma. |
| foc | Išsaugota galutinio įsipareigojimo dėl užsakymo planavimo reikšmė. Ji gali būti tuščia; apdorojimo funkcija jos nekonvertuoja į dokumentuotą laiko juostą ar laiko žymos formatą. |
| updated, date_created, date_completed | Išsaugotos atnaujinimo, sukūrimo ir užbaigimo reikšmės. Tuščias reikšmes apdorokite aiškiai; nedarykite prielaidos, kad naudojamas ISO8601 formatas, ir nenustatykite laiko juostos pagal išgalvotą pavyzdį. |
| comment | Išsaugotas klientui skirtas komentaras. Rodykite jį kaip tekstą, o ne kaip vykdomą HTML. |
Šis duomenų vaizdas neįtraukia tik darbuotojams skirto lauko internal_comment. Tai nereiškia, kad atskira senesnė vieno numerio paieška naudoja tą patį duomenų vaizdą.
Rikiavimas ir stebėjimas
Užklausa rikiuoja didėjančia sukūrimo laiko tvarka. Eilutėms, kurių sukūrimo laikas sutampa, papildoma tvarka negarantuojama. Nėra puslapiavimo, inkrementinio žymeklio ar datos filtro. Perskaitykite visą sąrašą, kad sutikrintumėte projekto duomenis, ir nelaikykite dabartinio jo eilučių skaičiaus nuolatiniu katalogu.
Numerių perkėlimo būsenos aiškinimas
| Reikšmė | Žyma |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Išsaugokite skaitinę būseną ir apdorokite nežinomas reikšmes. Nežinomų žymų atveju naudojama išsaugota reikšmė, negarantuojant naujos žymos. Išsaugota užbaigimo būsena ar suplanuota data savaime nepatikrina įeinančio maršruto parinkimo ar visų numerio paslaugų.
Klaidos ir apribojimai
Tikrinkite ir HTTP atsakymą, ir status.code/status.msg. Neegzistuojantis, ištrintas ar paskyrai nepriklausantis projektas grąžina API kodą 404 su pranešimu, kad projektas nerastas. Taip pat taikomi autentifikavimo ir šaltinio IP apribojimai. Pavyzdžiai neatlieka tikros užklausos, o sėkmingas atsakymas neįrodo, kad operatorius priėmė ar užbaigė perkėlimą.
Poveikis
Peržiūrėta apdorojimo funkcija tik skaito projektą ir jo išsaugotas numerių eilutes. Atsakymas yra momentinė duomenų kopija, o ne operatoriaus patvirtinimas ar tiesioginis paslaugos bandymas. Jis nepradeda numerių perkėlimo, nekeičia maršruto parinkimo ir nenuskaito lėšų iš paskyros.