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 het proces voor porteringsaanvragen, niet de numerieke database-ID of een telefoonnummer. Pas URL-codering toe op de project-ID wanneer u een verzoek samenstelt.
Verzoek
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Antwoord
Fictief voorbeeld van een antwoord.
{
"status": {
"code": 200,
"msg": "Project Events",
"results": 1
},
"response": [
{
"id": 31,
"subject": "Example project update",
"event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
"type": "comment",
"value": "Example update",
"source": "Example source",
"date_created": "2026-10-23 12:00:00"
}
]
}Een bestaand project zonder gebeurtenissen retourneert API-code 200, een lege lijst en status.results met de waarde 0. Resultaten worden opgevraagd in aflopende volgorde van aanmaaktijd, zonder aanvullende sortering bij gelijke tijden, paginering, cursor of datumfilter.
Lees de gebeurtenisgegevens zorgvuldig
id is de numerieke ID van de gebeurtenisrij, subject is het opgeslagen onderwerp en date_created is de opgeslagen datum- en tijdwaarde. Het eindpunt behoudt de onbewerkte tekenreeks event en probeert ook de daarin opgenomen velden te decoderen: type, value en source. Als de gebeurtenisgegevens geen JSON-object vormen of een eigenschap ontbreekt, bevat het bijbehorende veld na het ontleden een lege tekenreeks.
De gebeurtenisgegevens zijn niet beperkt tot een vaste opsomming van waarden en volgen niet gegarandeerd een schema voor platte tekst. Beschouw de tekst van de bron niet als een geverifieerde identiteit en geef de inhoud van gebeurtenissen niet weer als HTML. Houd onbewerkte gebeurtenissen binnen geautoriseerde processen aan de serverzijde en toon geautoriseerde gebruikers alleen tekst die voor hen geschikt is. Dit eindpunt heeft geen afzonderlijk filter voor de zichtbaarheid van gebeurtenissen voor medewerkers en klanten en schermt geen inhoud af.
Geschiedenis biedt geen aflevergarantie
Dit is opgeslagen projectgeschiedenis, geen stroom webhooks, onveranderlijke synchronisatiecursor of volledig overzicht van elke databasewijziging. Het toevoegen van nummers via de beoordeelde handler voor het toevoegen van nummers maakt bijvoorbeeld op zichzelf geen gebeurtenis aan. Lees niet alleen de gebeurtenissen, maar controleer ook of de nummerlijst en de aantallen per status overeenkomen.
Fouten en beperkingen
Controleer zowel het HTTP-antwoord als status.code/status.msg. Een ontbrekend of verwijderd project, of een project dat niet bij het account hoort, retourneert API-code 404 met een melding dat het project niet is gevonden. Ook authenticatievereisten en beperkingen voor het bron-IP-adres zijn van toepassing. De voorbeelden voeren geen daadwerkelijk verzoek uit en een geslaagd antwoord bewijst niet dat een telecomaanbieder een portering heeft geaccepteerd of voltooid.
Gevolgen van de aanroep
De beoordeelde handler leest opgeslagen gebeurtenissen en wijzigt het project niet, start geen portering en schrijft geen bedrag van het account af. De zichtbaarheid van gebeurtenissen die door schrijfcomponenten worden vastgelegd en accounttests met authenticatie blijven onderdeel van de nog uit te voeren beoordeling van het API-contract.