Udviklere

GET/v3/lnp/project/{uniqueid}/events

Læs hændelser for et nummerporteringsprojekt

Hent gemt projekthistorik, og håndter rå eller fejlformaterede hændelsesdata.

På denne side
  1. Adgang til konto og projekt
  2. Anmodning
  3. Svar
  4. Læs hændelsesdataene omhyggeligt
  5. Historik er ikke en leveringsgaranti
  6. Fejl og begrænsninger
  7. Virkninger

Adgang til konto og projekt

Brug en aktiveret API-konto via HTTPS fra en tilladt IP-adresse. Projektet skal tilhøre denne konto og må ikke være slettet. Brug projektets entydige ID fra arbejdsgangen for bestilling af 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/events"

Svar

Fiktivt 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 projekt uden hændelser returnerer API-kode 200, en tom liste og status.results lig med 0. Resultater anmodes om i faldende rækkefølge efter oprettelsestidspunkt, uden yderligere sortering ved identiske tidspunkter, sideinddeling, markør eller datofilter.

Læs hændelsesdataene omhyggeligt

id er hændelsesrækkens numeriske ID, subject er dens gemte emne, og date_created er dens gemte dato- og tidsværdi. Endepunktet bevarer den rå event-streng og forsøger også at afkode dens type, value og source. Hvis hændelsesdataene ikke er et JSON-objekt, eller en egenskab mangler, er det tilsvarende fortolkede felt en tom streng.

Hændelsesdataene følger hverken en fast opregning af tilladte værdier eller et garanteret skema for ren tekst. Betragt ikke kildetekst som en verificeret identitet, og gengiv ikke hændelsesindhold som HTML. Bevar rå hændelser i autoriserede arbejdsgange på serversiden, og vis kun passende tekst til autoriserede brugere. Dette endepunkt har hverken et særskilt filter for hændelsers synlighed for medarbejdere og kunder eller maskering af indhold.

Historik er ikke en leveringsgaranti

Dette er gemt projekthistorik, ikke en strøm af webhook-hændelser, en uforanderlig synkroniseringsmarkør eller en fuldstændig registrering af alle databaseændringer. Hvis der for eksempel tilføjes numre via den gennemgåede handler til tilføjelse af numre, opretter det ikke i sig selv en hændelse. Afstem også nummerlisten og antallene pr. status, ud over at læse hændelser.

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 meddelelse om, at projektet ikke blev fundet. Krav om autentificering og begrænsninger for kilde-IP-adresser gælder også. Eksemplerne sender ikke en faktisk anmodning, og et vellykket svar er ikke bevis for, at en teleoperatør har accepteret eller gennemført en nummerportering.

Virkninger

Den gennemgåede handler læser gemte hændelser og ændrer ikke projektet, starter ikke en nummerportering og debiterer ikke kontoen. Indsigt i den kode, der skriver hændelser, og kontotest med autentificering indgår fortsat i den udestående gennemgang af API-kontrakten.