Piekļuve kontam un projektam
Izmantojiet iespējotu API kontu, izmantojot HTTPS, no atļautas IP adreses. Projektam jāpieder šim kontam, un tas nedrīkst būt dzēsts. Izmantojiet projekta unikālo identifikatoru no numuru pārnešanas pasūtījuma darbplūsmas, nevis tā skaitlisko datubāzes identifikatoru vai tālruņa numuru. Veidojot pieprasījumu, piemērojiet projekta identifikatoram URL kodējumu.
Pieprasījums
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Atbilde
Izdomāts atbildes piemērs.
{
"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 ir saraksts. Esošs projekts bez numuriem atgriež tukšu sarakstu ar API kodu 200 un status.results vērtību 0. Savukārt neesoši projekti atgriež API kodu 404.
Numuru lauki
| Lauks | Nozīme |
|---|---|
| id, number, isocode | Rindas skaitliskais identifikators, saglabātais tālruņa numura teksts un valsts kods. Rindas identifikators nav projekta identifikators. |
| status, status_str | Skaitlisks statuss un tā zināmā etiķete. |
| foc | Saglabātā galīgās pasūtījuma apņemšanās plānošanas vērtība. Tā var būt tukša; apstrādātājs to nepārveido uz dokumentētu laika joslu vai laikspiedola formātu. |
| updated, date_created, date_completed | Saglabātās atjaunināšanas, izveides un pabeigšanas vērtības. Tukšās vērtības apstrādājiet nepārprotami; nepieņemiet ISO8601 formātu un neizseciniet laika joslu no izdomātā piemēra. |
| comment | Saglabāts klientam paredzēts komentārs. Attēlojiet to kā tekstu, nevis izpildāmu HTML. |
Šis datu attēlojums izlaiž tikai darbiniekiem paredzēto lauku internal_comment. Tas nenozīmē, ka atsevišķā vecā viena numura uzmeklēšana izmanto tādu pašu datu attēlojumu.
Secība un uzraudzība
Vaicājums kārto pēc izveides laika augošā secībā. Rindām ar vienādu izveides laiku nav garantēta papildu secība. Nav dalījuma lapās, inkrementāla kursora vai datuma filtra. Izlasiet visu sarakstu, lai salīdzinātu un saskaņotu projekta datus, un neuzskatiet tā pašreizējo rindu skaitu par pastāvīgu katalogu.
Numuru pārnešanas statusa interpretēšana
| Vērtība | Etiķete |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Saglabājiet skaitlisko statusu un apstrādājiet nezināmas vērtības. Nezināmu etiķešu gadījumā tiek izmantota saglabātā vērtība, negarantējot jaunu etiķeti. Saglabāts pabeigšanas statuss vai ieplānots datums pats par sevi nepārbauda ienākošo maršrutēšanu vai visus numura pakalpojumus.
Kļūdas un ierobežojumi
Pārbaudiet gan HTTP atbildi, gan status.code/status.msg. Neesošs, dzēsts vai kontam nepiederošs projekts atgriež API kodu 404 ar ziņojumu, ka projekts nav atrasts. Ir spēkā arī autentifikācijas un avota IP ierobežojumi. Piemēri neveic reālu pieprasījumu, un veiksmīga atbilde nepierāda, ka operators ir pieņēmis vai pabeidzis pārnešanu.
Ietekme
Pārskatītais apstrādātājs tikai nolasa projektu un tā saglabātās numuru rindas. Atbilde ir datu momentuzņēmums, nevis operatora apstiprinājums vai pakalpojuma pārbaude reāllaikā. Tā nesāk numuru pārnešanu, nemaina maršrutēšanu un neiekasē maksu no konta.