Tilin ja projektin käyttöoikeus
Käytä käyttöön otettua API-tiliä HTTPS-yhteydellä sallitusta IP-osoitteesta. Projektin on kuuluttava kyseiselle tilille, eikä se saa olla poistettu. Käytä numeronsiirtotilauksen työnkulusta saatua projektin yksilöllistä tunnistetta, älä sen numeerista tietokantatunnistetta tai puhelinnumeroa. URL-koodaa projektin tunniste pyyntöä muodostaessasi.
Pyyntö
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Vastaus
Kuvitteellinen vastausesimerkki.
{
"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 luettelo. Olemassa oleva projekti, jossa ei ole numeroita, palauttaa tyhjän luettelon API-koodilla 200, ja status.results on arvoltaan 0. Puuttuvat projektit puolestaan palauttavat API-koodin 404.
Numeroiden kentät
| Kenttä | Merkitys |
|---|---|
| id, number, isocode | Numeerinen rivitunniste, tallennettu puhelinnumeroteksti ja maakoodi. Rivitunniste ei ole projektin tunniste. |
| status, status_str | Numeerinen tila ja sen tunnettu nimike. |
| foc | Sitovan tilausvahvistuksen tallennettu ajoitusarvo. Se voi olla tyhjä; käsittelijä ei muunna sitä dokumentoituun aikavyöhykkeeseen tai aikaleimamuotoon. |
| updated, date_created, date_completed | Tallennetut päivitys-, luonti- ja valmistumisarvot. Käsittele tyhjät arvot nimenomaisesti; älä oleta ISO8601-muotoa tai päättele aikavyöhykettä kuvitteellisesta esimerkistä. |
| comment | Tallennettu asiakkaalle tarkoitettu kommentti. Näytä se tekstinä, älä suoritettavana HTML-koodina. |
Tämä tietonäkymä jättää pois vain henkilökunnalle tarkoitetun internal_comment-kentän. Tämä ei tarkoita, että erillinen vanha yksittäisen numeron haku käyttäisi samaa tietonäkymää.
Järjestys ja seuranta
Kysely järjestää rivit luontiajan mukaan nousevaan järjestykseen. Saman luontiajan omaaville riveille ei taata muuta järjestystä. Sivutusta, inkrementaalista kohdistinta tai päivämääräsuodatinta ei ole. Lue koko luettelo projektin tietojen täsmäyttämiseksi, äläkä pidä sen nykyistä rivimäärää pysyvänä luettelona.
Numeronsiirron tilan tulkinta
| Arvo | Nimike |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Säilytä numeerinen tila ja käsittele tuntemattomat arvot. Tuntemattomien nimikkeiden tilalla käytetään tallennettua arvoa, eikä uutta nimikettä taata. Tallennettu valmistumistila tai ajoitettu päivämäärä ei itsessään testaa saapuvien puhelujen reititystä tai numeron kaikkia palveluja.
Virheet ja rajoitukset
Tarkista sekä HTTP-vastaus että status.code/status.msg. Puuttuva, poistettu tai toiselle tilille kuuluva projekti palauttaa API-koodin 404 sekä ilmoituksen siitä, ettei projektia löydy. Myös todennus- ja lähde-IP-rajoitukset ovat voimassa. Esimerkit eivät tee todellista pyyntöä, eikä onnistunut vastaus todista, että operaattori olisi hyväksynyt tai suorittanut siirron loppuun.
Vaikutukset
Tarkastettu käsittelijä vain lukee projektin ja sen tallennetut numerorivit. Vastaus on tilannekuva, ei operaattorin vahvistus tai palvelun reaaliaikainen testi. Se ei käynnistä numeronsiirtoa, muuta reititystä tai veloita tiliä.