Toegang tot account en project
Gebruik een ingeschakeld API-account via HTTPS vanaf een toegestaan IP-adres. Het project moet bij dat account horen en mag niet verwijderd zijn. Gebruik de unieke project-ID uit de bestelworkflow voor nummerportering, niet de numerieke database-ID of een telefoonnummer. Pas URL-codering toe op de project-ID wanneer u een verzoek opbouwt.
Verzoek
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Antwoord
Fictief antwoordvoorbeeld.
{
"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 is een lijst. Een bestaand project zonder nummers geeft een lege lijst terug met API-code 200 en een waarde voor status.results gelijk aan 0. Niet-bestaande projecten geven daarentegen API-code 404 terug.
Nummervelden
| Veld | Betekenis |
|---|---|
| id, number, isocode | Numerieke rij-ID, opgeslagen telefoonnummertekst en landcode. De rij-ID is niet de project-ID. |
| status, status_str | Numerieke status en het bijbehorende bekende label. |
| foc | Opgeslagen planningswaarde van de bindende orderbevestiging. Deze kan leeg zijn; de handler zet de waarde niet om naar een gedocumenteerde tijdzone of tijdstempelnotatie. |
| updated, date_created, date_completed | Opgeslagen waarden voor bijwerken, aanmaken en voltooien. Handel lege waarden expliciet af; ga niet uit van ISO8601 en leid geen tijdzone af uit het fictieve voorbeeld. |
| comment | Opgeslagen opmerking voor de klant. Toon deze als tekst, niet als uitvoerbare HTML. |
Deze gegevensweergave laat het veld internal_comment weg, dat alleen voor medewerkers is bedoeld. Dit betekent niet dat de afzonderlijke oudere zoekfunctie voor één nummer dezelfde gegevensweergave gebruikt.
Volgorde en bewaking
De query sorteert oplopend op aanmaaktijdstip. Voor rijen met hetzelfde aanmaaktijdstip is geen aanvullende volgorde gegarandeerd. Er is geen paginering, incrementele cursor of datumfilter. Lees de volledige lijst om de gegevens van een project af te stemmen en beschouw het huidige aantal rijen niet als een permanente catalogus.
Porteringsstatus interpreteren
| Waarde | Label |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Bewaar de numerieke status en houd rekening met onbekende waarden. Bij onbekende labels wordt de opgeslagen waarde gebruikt, zonder garantie op een nieuw label. Een opgeslagen voltooiingsstatus of geplande datum test op zichzelf niet de inkomende routering of alle diensten op het nummer.
Fouten en beperkingen
Controleer zowel het HTTP-antwoord als status.code/status.msg. Een niet-bestaand of verwijderd project, of een project dat niet bij het account hoort, geeft API-code 404 terug met een melding dat het project niet is gevonden. Beperkingen voor authenticatie en bron-IP zijn eveneens van toepassing. De voorbeelden voeren geen werkelijk verzoek uit en een geslaagd antwoord bewijst niet dat een provider een overdracht heeft geaccepteerd of voltooid.
Effecten
De beoordeelde handler leest alleen het project en de opgeslagen nummerrijen ervan. Het antwoord is een momentopname, geen bevestiging van een provider of een live diensttest. Het start geen portering, wijzigt geen routering en schrijft geen bedrag van het account af.