Hozzáférés a fiókhoz és a projekthez
Használjon engedélyezett API-fiókot HTTPS-kapcsolaton keresztül, engedélyezett IP-címről. A projektnek ehhez a fiókhoz kell tartoznia, és nem lehet törölt. A számhordozási megrendelési folyamatból származó egyedi projektazonosítót használja, ne a projekt számszerű adatbázis-azonosítóját vagy egy telefonszámot. A kérés összeállításakor alkalmazzon URL-kódolást a projektazonosítóra.
Kérés
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Válasz
Kitalált válaszpélda.
{
"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 egy lista. Egy létező, számok nélküli projekt üres listát ad vissza 200 értékű API-kóddal és a status.results mező 0 értékével. A nem létező projektek ezzel szemben 404 értékű API-kódot adnak vissza.
A számok mezői
| Mező | Jelentés |
|---|---|
| id, number, isocode | A sor számszerű azonosítója, a telefonszám tárolt szövege és az országkód. A sor azonosítója nem a projekt azonosítója. |
| status, status_str | Számszerű állapot és annak ismert címkéje. |
| foc | A megrendelésre vonatkozó végleges kötelezettségvállalás tárolt ütemezési értéke. Lehet üres; a kezelő nem alakítja át dokumentált időzónára vagy időbélyeg-formátumra. |
| updated, date_created, date_completed | Tárolt frissítési, létrehozási és befejezési értékek. Az üres értékeket kifejezetten kezelje; ne feltételezzen ISO8601 formátumot, és ne következtessen időzónára a kitalált példából. |
| comment | Az ügyfélnek szánt tárolt megjegyzés. Szövegként jelenítse meg, ne végrehajtható HTML-ként. |
Ez az adatnézet kihagyja az internal_comment mezőt, amely kizárólag a munkatársaknak szól. Ez nem jelenti azt, hogy az egyetlen számra vonatkozó különálló, régi lekérdezés ugyanezt az adatnézetet használja.
Sorrend és nyomon követés
A lekérdezés a létrehozás ideje szerint növekvő sorrendbe rendezi a találatokat. Azonos létrehozási idejű sorok esetén nincs további garantált sorrend. Nincs lapozás, növekményes kurzor vagy dátumszűrő. A projekt adatainak egyeztetéséhez olvassa be a teljes listát, és ne tekintse a sorok aktuális számát állandó katalógusnak.
A számhordozási állapot értelmezése
| Érték | Címke |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Őrizze meg a számszerű állapotot, és kezelje az ismeretlen értékeket. Ismeretlen címkék esetén a tárolt érték használatos, új címke garantálása nélkül. A tárolt befejezési állapot vagy ütemezett dátum önmagában nem teszteli a bejövő útválasztást vagy a szám összes szolgáltatását.
Hibák és korlátok
Ellenőrizze mind a HTTP-választ, mind a status.code/status.msg értékét. A nem létező, törölt vagy nem a fiókhoz tartozó projekt 404 értékű API-kódot ad vissza, a projekt hiányát jelző üzenettel. A hitelesítési és forrás-IP-korlátozások is érvényesek. A példák nem hajtanak végre élő kérést, és a sikeres válasz nem bizonyítja, hogy egy szolgáltató elfogadott vagy befejezett egy átvitelt.
Hatások
A felülvizsgált kezelő csak a projektet és annak tárolt számsorait olvassa. A válasz pillanatfelvétel, nem szolgáltatói visszaigazolás vagy élő szolgáltatásteszt. Nem indít számhordozást, nem változtatja meg az útválasztást, és nem terheli meg a fiókot.