Přístup k účtu a projektu
Použijte povolený účet API přes HTTPS z povolené IP adresy. Projekt musí patřit tomuto účtu a nesmí být odstraněný. Použijte jedinečný identifikátor projektu z procesu objednávky přenosu čísla, nikoli jeho číselný identifikátor v databázi ani telefonní číslo. Při sestavování požadavku použijte pro identifikátor projektu kódování URL.
Požadavek
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Odpověď
Smyšlený příklad odpovědi.
{
"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 je seznam. Existující projekt bez čísel vrací prázdný seznam s kódem API 200 a hodnotou status.results rovnou 0. Neexistující projekty naopak vracejí kód API 404.
Pole čísel
| Pole | Význam |
|---|---|
| id, number, isocode | Číselný identifikátor řádku, uložený text telefonního čísla a kód země. Identifikátor řádku není identifikátorem projektu. |
| status, status_str | Číselný stav a jeho známý popisek. |
| foc | Uložená plánovací hodnota závazného potvrzení objednávky. Může být prázdná; obslužná funkce ji nepřevádí na zdokumentované časové pásmo ani formát časového razítka. |
| updated, date_created, date_completed | Uložené hodnoty aktualizace, vytvoření a dokončení. Prázdné hodnoty zpracujte výslovně; nepředpokládejte formát ISO8601 ani neodvozujte časové pásmo ze smyšleného příkladu. |
| comment | Uložený komentář určený zákazníkovi. Zobrazujte jej jako text, nikoli jako spustitelné HTML. |
Tento datový výstup vynechává pole internal_comment určené pouze zaměstnancům. Neznamená to, že samostatné starší vyhledávání jednotlivého čísla používá stejný datový výstup.
Řazení a sledování
Dotaz řadí výsledky vzestupně podle času vytvoření. U řádků se shodným časem vytvoření není zaručeno žádné další pořadí. Není k dispozici stránkování, přírůstkový kurzor ani filtr data. Pro porovnání a sladění dat projektu načtěte celý seznam a nepovažujte jeho aktuální počet řádků za trvalý katalog.
Výklad stavu přenosu
| Hodnota | Popisek |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Uchovávejte číselný stav a počítejte s neznámými hodnotami. U neznámých popisků se použije uložená hodnota, aniž by byl zaručen nový popisek. Uložený stav dokončení nebo naplánované datum samy o sobě netestují příchozí směrování ani všechny služby čísla.
Chyby a omezení
Zkontrolujte odpověď HTTP i status.code/status.msg. Neexistující, odstraněný nebo jinému účtu patřící projekt vrací kód API 404 se zprávou, že projekt nebyl nalezen. Platí také omezení ověřování a zdrojové IP adresy. Příklady neprovádějí skutečný požadavek a úspěšná odpověď není důkazem, že operátor přenos přijal nebo dokončil.
Účinky
Zkontrolovaná obslužná funkce pouze čte projekt a jeho uložené řádky čísel. Odpověď je snímek dat, nikoli potvrzení operátora ani živý test služby. Nezahajuje přenos, nemění směrování ani neúčtuje částku na vrub účtu.