Tilgang til konto og prosjekt
Bruk en aktivert API-konto over HTTPS fra en tillatt IP-adresse. Prosjektet må tilhøre den kontoen og må ikke være slettet. Bruk prosjektets unike ID fra arbeidsflyten for porteringsbestillinger, ikke den numeriske database-ID-en eller et telefonnummer. URL-kod prosjekt-ID-en når du bygger en forespørsel.
Forespørsel
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 prosjekt uten numre returnerer en tom liste med API-kode 200 og en verdi for status.results lik 0. Prosjekter som ikke finnes, returnerer derimot API-kode 404.
Nummerfelter
| Felt | Betydning |
|---|---|
| id, number, isocode | Numerisk rad-ID, lagret telefonnummertekst og landskode. Rad-ID-en er ikke prosjekt-ID-en. |
| status, status_str | Numerisk status og den kjente etiketten for den. |
| foc | Lagret planleggingsverdi for den bindende ordrebekreftelsen. Den kan være tom; behandleren konverterer den ikke til en dokumentert tidssone eller et dokumentert tidsstempelformat. |
| updated, date_created, date_completed | Lagrede verdier for oppdatering, opprettelse og fullføring. Håndter tomme verdier uttrykkelig; ikke anta ISO8601 eller utled en tidssone fra det fiktive eksemplet. |
| comment | Lagret kommentar beregnet på kunden. Vis den som tekst, ikke som kjørbar HTML. |
Denne datavisningen utelater feltet internal_comment som bare er beregnet på ansatte. Det betyr ikke at det separate, eldre oppslaget for ett enkelt nummer bruker samme datavisning.
Rekkefølge og overvåking
Spørringen sorterer stigende etter opprettelsestidspunkt. Rader med samme opprettelsestidspunkt har ingen ytterligere garantert rekkefølge. Det finnes ingen sideinndeling, inkrementell markør eller datofilter. Les hele listen for å avstemme et prosjekts data, og ikke betrakt det nåværende radantallet som en permanent katalog.
Tolk porteringsstatus
| Verdi | Etikett |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Behold den numeriske statusen og håndter ukjente verdier. For ukjente etiketter brukes den lagrede verdien, uten at en ny etikett garanteres. En lagret fullføringsstatus eller planlagt dato tester ikke i seg selv innkommende ruting eller alle tjenester på nummeret.
Feil og begrensninger
Kontroller både HTTP-svaret og status.code/status.msg. Et prosjekt som ikke finnes, er slettet eller ikke tilhører kontoen, returnerer API-kode 404 med en melding om at prosjektet ikke ble funnet. Begrensninger for autentisering og kilde-IP gjelder også. Eksemplene utfører ingen virkelig forespørsel, og et vellykket svar beviser ikke at en operatør har godtatt eller fullført en overføring.
Virkninger
Den gjennomgåtte behandleren leser bare prosjektet og de lagrede nummerradene. Svaret er et øyeblikksbilde, ikke en operatørbekreftelse eller en test av tjenesten i drift. Det starter ikke en portering, endrer ikke ruting og belaster ikke kontoen.