Juurdepääs kontole ja projektile
Kasutage lubatud IP-aadressilt aktiveeritud API-kontot HTTPS-ühenduse kaudu. Projekt peab kuuluma sellele kontole ega tohi olla kustutatud. Kasutage numbri teisaldamise tellimuse töövoost saadud projekti kordumatut tunnust, mitte selle arvulist andmebaasitunnust ega telefoninumbrit. Päringu koostamisel URL-kodeerige projekti tunnus.
Päring
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Vastus
Väljamõeldud vastuse näide.
{
"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 on loend. Olemasolev numbriteta projekt tagastab tühja loendi API koodiga 200 ning status.results väärtus on 0. Puuduvad projektid tagastavad seevastu API koodi 404.
Numbrite väljad
| Väli | Tähendus |
|---|---|
| id, number, isocode | Rea arvuline tunnus, salvestatud telefoninumbri tekst ja riigikood. Rea tunnus ei ole projekti tunnus. |
| status, status_str | Arvuline olek ja selle teadaolev nimetus. |
| foc | Tellimuse siduva kinnituse salvestatud ajastusväärtus. See võib olla tühi; töötleja ei teisenda seda dokumenteeritud ajavööndisse ega ajatempli vormingusse. |
| updated, date_created, date_completed | Salvestatud uuendamise, loomise ja lõpetamise väärtused. Käsitlege tühje väärtusi selgesõnaliselt; ärge eeldage vormingut ISO8601 ega tuletage ajavööndit väljamõeldud näitest. |
| comment | Salvestatud kliendile mõeldud kommentaar. Kuvage seda tekstina, mitte käivitatava HTML-ina. |
See andmevaade jätab välja ainult töötajatele mõeldud välja internal_comment. See ei tähenda, et eraldi vanem ühe numbri otsing kasutaks sama andmevaadet.
Järjestus ja jälgimine
Päring järjestab tulemused loomisaja järgi kasvavalt. Sama loomisajaga ridadele ei ole tagatud täiendavat järjestust. Lehekülgedeks jaotamist, juurdekasvukursorit ega kuupäevafiltrit ei ole. Projekti andmete võrdlemiseks ja kooskõlastamiseks lugege kogu loend ning ärge käsitlege selle praegust ridade arvu püsiva kataloogina.
Numbrite teisaldamise oleku tõlgendamine
| Väärtus | Nimetus |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Säilitage arvuline olek ja arvestage tundmatute väärtustega. Tundmatute nimetuste korral kasutatakse salvestatud väärtust, tagamata uut nimetust. Salvestatud lõpetamisolek või kavandatud kuupäev ei ole iseenesest sissetuleva marsruutimise ega kõigi numbri teenuste test.
Vead ja piirangud
Kontrollige nii HTTP-vastust kui ka status.code/status.msg. Puuduv, kustutatud või kontole mittekuuluv projekt tagastab API koodi 404 koos teatega, et projekti ei leitud. Kehtivad ka autentimise ja lähte-IP piirangud. Näited ei tee tegelikku päringut ning edukas vastus ei tõesta, et operaator on teisaldamise vastu võtnud või lõpetanud.
Mõju
Üle vaadatud töötleja ainult loeb projekti ja selle salvestatud numbriridu. Vastus on hetktõmmis, mitte operaatori kinnitus ega reaalajas teenusetest. See ei algata numbri teisaldamist, ei muuda marsruutimist ega võta kontolt tasu.