Utvecklare

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

Läs händelser i nummerporteringsprojekt

Hämta lagrad projekthistorik och hantera obearbetade eller felaktigt formaterade händelsedata.

På denna sida
  1. Åtkomst till konto och projekt
  2. Begäran
  3. Svar
  4. Läs händelsens nyttolast noggrant
  5. Historiken garanterar inte leverans
  6. Fel och begränsningar
  7. Effekter

Åtkomst till konto och projekt

Använd ett aktiverat API-konto via HTTPS från en tillåten IP-adress. Projektet måste tillhöra det kontot och får inte vara borttaget. Använd projektets unika ID från arbetsflödet för porteringsbeställningar, inte dess numeriska databas-ID eller ett telefonnummer. URL-koda projektets ID när du skapar en begäran.

Begäran

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"

Svar

Fiktivt exempel på ett 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"
    }
  ]
}

Ett befintligt projekt utan händelser returnerar API-kod 200, en tom lista och status.results med värdet 0. Resultaten begärs i fallande ordning efter när de skapades, utan ytterligare sortering vid identiska tidpunkter, sidindelning, markör eller datumfilter.

Läs händelsens nyttolast noggrant

id är händelseradens numeriska ID, subject är dess lagrade ämne och date_created är dess lagrade datum- och tidsvärde. Ändpunkten bevarar den obearbetade event-strängen och försöker även avkoda dess type, value och source. Om nyttolasten inte är ett JSON-objekt eller om en egenskap saknas är motsvarande parsade fält en tom sträng.

Nyttolasten är inte en fast uppräkningstyp och följer inte något garanterat schema för oformaterad text. Behandla inte källtext som en verifierad identitet och återge inte händelseinnehåll som HTML. Behåll obearbetade händelser i behörighetsstyrda arbetsflöden på serversidan och visa endast lämplig text för behöriga användare. Den här ändpunkten har inget separat filter för vilka händelser som är synliga för personal respektive kunder och ingen maskering av innehåll.

Historiken garanterar inte leverans

Detta är lagrad projekthistorik, inte en ström av webhooks, en oföränderlig synkroniseringsmarkör eller en fullständig förteckning över varje databasändring. Att lägga till nummer via den granskade hanteraren för att lägga till nummer skapar till exempel inte i sig någon händelse. Stäm även av nummerlistan och antalet nummer per status utöver att läsa händelserna.

Fel och begränsningar

Kontrollera både HTTP-svaret och status.code/status.msg. Ett projekt som saknas, är borttaget eller inte tillhör kontot returnerar API-kod 404 med ett meddelande om att projektet inte hittades. Även autentisering och begränsningar för källans IP-adress gäller. Exemplen gör ingen verklig begäran, och ett lyckat svar är inget bevis på att en operatör har godkänt eller slutfört en portering.

Effekter

Den granskade hanteraren läser lagrade händelser och ändrar inte projektet, startar ingen portering och debiterar inte kontot. Insyn i komponenter som skriver händelser och autentiserad kontotestning ingår fortfarande i den återstående granskningen av API-kontraktet.