Tilgang til konto og prosjekt
Bruk en aktivert API-konto over HTTPS fra en tillatt IP-adresse. Prosjektet må tilhøre denne 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/events"Svar
Oppdiktet eksempel på et svar.
{
"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"
}
]
}Et eksisterende prosjekt uten hendelser returnerer API-kode 200, en tom liste og status.results lik 0. Resultatene forespørres i synkende rekkefølge etter opprettelsestidspunkt, uten ytterligere sortering ved like tidspunkt, sideinndeling, markør eller datofilter.
Les hendelsesdataene nøye
id er den numeriske ID-en til hendelsesraden, subject er det lagrede emnet, og date_created er den lagrede dato- og tidsverdien. Endepunktet bevarer den ubehandlede event-strengen og forsøker også å dekode egenskapene type, value og source. Hvis hendelsesdataene ikke er et JSON-objekt, eller en egenskap mangler, er det tilsvarende feltet etter parsing en tom streng.
Hendelsesdataene er ikke en fast opplisting av verdier og følger ikke et garantert skjema for ren tekst. Ikke behandle kildetekst som en bekreftet identitet eller gjengi hendelsesinnhold som HTML. Behold rå hendelser i arbeidsflyter på serversiden med tilgangskontroll, og vis bare egnet tekst til autoriserte brukere. Dette endepunktet har ikke noe eget filter for hendelsessynlighet for ansatte og kunder eller noen sladding av innhold.
Historikk er ingen leveringsgaranti
Dette er lagret prosjekthistorikk, ikke en strøm av webhooks, en uforanderlig synkroniseringsmarkør eller en fullstendig oversikt over alle databaseendringer. Hvis du for eksempel legger til numre gjennom den gjennomgåtte behandlingsfunksjonen for å legge til numre, oppretter ikke dette i seg selv en hendelse. Avstem også nummerlisten og antall per status i tillegg til å lese hendelser.
Feil og begrensninger
Kontroller både HTTP-svaret og status.code/status.msg. Et prosjekt som mangler, er slettet eller ikke tilhører kontoen, returnerer API-kode 404 med en melding om at prosjektet ikke ble funnet. Autentisering og begrensninger for kilde-IP gjelder også. Eksemplene sender ingen faktisk forespørsel, og et vellykket svar er ikke bevis på at en operatør har godtatt eller fullført en portering.
Virkninger
Den gjennomgåtte behandlingsfunksjonen leser lagrede hendelser og endrer ikke prosjektet, starter ikke en portering og belaster ikke kontoen. Innsyn i hvilke deler av systemet som skriver hendelser, og testing med autentisert kontotilgang inngår fortsatt i den utestående gjennomgangen av grensesnittkontrakten.