Adgang til konto og projekt
Brug en aktiveret API-konto via HTTPS fra en tilladt IP-adresse. Projektet skal tilhøre den konto og må ikke være slettet. Brug projektets entydige ID fra bestillingsforløbet for nummerportering, ikke dets numeriske database-ID eller et telefonnummer. URL-kod projektets ID, når du opbygger en anmodning.
Anmodning
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Svar
Fiktivt svareksempel.
{
"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 er en liste. Et eksisterende projekt uden numre returnerer en tom liste med API-kode 200 og en værdi for status.results på 0. Projekter, der ikke findes, returnerer derimod API-kode 404.
Nummerfelter
| Felt | Betydning |
|---|---|
| id, number, isocode | Numerisk række-ID, gemt telefonnummertekst og landekode. Rækkens ID er ikke projektets ID. |
| status, status_str | Numerisk status og dens kendte etiket. |
| foc | Gemt planlægningsværdi for den bindende ordrebekræftelse. Den kan være tom; behandleren konverterer den ikke til en dokumenteret tidszone eller et dokumenteret tidsstempelformat. |
| updated, date_created, date_completed | Gemte værdier for opdatering, oprettelse og fuldførelse. Håndter tomme værdier udtrykkeligt; antag ikke ISO8601, og udled ikke en tidszone af det fiktive eksempel. |
| comment | Gemt kommentar til kunden. Vis den som tekst, ikke som eksekverbar HTML. |
Denne datavisning udelader feltet internal_comment, som kun er beregnet til medarbejdere. Det betyder ikke, at det separate ældre opslag på ét nummer bruger samme datavisning.
Rækkefølge og overvågning
Forespørgslen sorterer stigende efter oprettelsestidspunkt. Rækker med samme oprettelsestidspunkt har ingen yderligere garanteret rækkefølge. Der er ingen sideinddeling, inkrementel markør eller datofilter. Læs hele listen for at afstemme et projekts data, og betragt ikke det aktuelle antal rækker som et permanent katalog.
Fortolk porteringsstatus
| Værdi | Etiket |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Bevar den numeriske status, og håndter ukendte værdier. Ved ukendte etiketter bruges den gemte værdi uden garanti for en ny etiket. En gemt fuldførelsesstatus eller en planlagt dato tester ikke i sig selv indgående routing eller alle tjenester på nummeret.
Fejl og begrænsninger
Kontrollér både HTTP-svaret og status.code/status.msg. Et projekt, der ikke findes, er slettet eller ikke tilhører kontoen, returnerer API-kode 404 med en besked om, at projektet ikke blev fundet. Begrænsninger for autentificering og kilde-IP gælder også. Eksemplerne foretager ingen faktisk anmodning, og et vellykket svar beviser ikke, at en operatør har accepteret eller fuldført en overførsel.
Virkninger
Den gennemgåede behandler læser kun projektet og dets gemte nummerrækker. Svaret er et øjebliksbillede, ikke en bekræftelse fra operatøren eller en faktisk tjenestetest. Det starter ikke en portering, ændrer ikke routing og debiterer ikke kontoen.