Leximi i ngjarjeve të projektit të bartjes së numrave

Qasja në llogari dhe në projekt

Përdorni një llogari API të aktivizuar përmes HTTPS nga një adresë IP e lejuar. Projekti duhet t'i përkasë asaj llogarie dhe nuk duhet të jetë i fshirë. Përdorni identifikuesin unik të projektit nga rrjedha e punës për porosinë e bartjes së numrave, jo identifikuesin e tij numerik në bazën e të dhënave ose një numër telefoni. Kur ndërtoni një kërkesë, kodojeni identifikuesin e projektit sipas kodimit URL.

Kërkesa

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

Përgjigjja

Shembull i trilluar i një përgjigjeje.

{
  "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"
    }
  ]
}

Një projekt ekzistues pa ngjarje kthen kodin API 200, një listë bosh dhe status.results të barabartë me 0. Rezultatet kërkohen sipas kohës së krijimit në rend zbritës, pa renditje shtesë për kohë të njëjta, pa ndarje në faqe, kursor ose filtër sipas datës.

Lexojini me kujdes të dhënat e ngjarjes

id është identifikuesi numerik i rreshtit të ngjarjes, subject është subjekti i saj i ruajtur, ndërsa date_created është vlera e ruajtur e datës dhe orës së saj. Pika fundore ruan vargun e papërpunuar event dhe gjithashtu përpiqet të dekodojë vetitë e tij type, value dhe source. Nëse të dhënat e ngjarjes nuk janë një objekt JSON ose mungon një veti, fusha përkatëse e nxjerrë nga analizimi është një varg bosh.

Të dhënat e ngjarjes nuk përbëjnë një bashkësi fikse vlerash të numëruara dhe as nuk garantohet se ndjekin një skemë teksti të thjeshtë. Mos e trajtoni tekstin e burimit si identitet të verifikuar dhe mos e paraqitni përmbajtjen e ngjarjes si HTML. Mbajini ngjarjet e papërpunuara në rrjedha pune të autorizuara në anën e serverit dhe shfaquni përdoruesve të autorizuar vetëm tekstin e përshtatshëm. Kjo pikë fundore nuk ka filtër të veçantë për dukshmërinë e ngjarjeve për personelin dhe klientët dhe nuk maskon përmbajtjen.

Historiku nuk garanton dorëzimin

Ky është historiku i ruajtur i projektit, jo një rrjedhë webhook-ësh, një kursor sinkronizimi i pandryshueshëm apo një regjistër i plotë i çdo ndryshimi në bazën e të dhënave. Për shembull, shtimi i numrave përmes trajtuesit të shqyrtuar për shtimin e numrave nuk krijon vetvetiu një ngjarje. Përveç leximit të ngjarjeve, kontrolloni përputhshmërinë e listës së numrave dhe të numërimeve sipas statusit.

Gabimet dhe kufizimet

Kontrolloni si përgjigjen HTTP, ashtu edhe status.code/status.msg. Një projekt që mungon, është fshirë ose nuk i përket llogarisë kthen kodin API 404 me një mesazh që tregon se projekti nuk u gjet. Zbatohen gjithashtu kërkesat e autentikimit dhe kufizimet për adresën IP të burimit. Shembujt nuk kryejnë një kërkesë reale dhe një përgjigje e suksesshme nuk provon se një operator ka pranuar ose përfunduar një transferim.

Efektet

Trajtuesi i shqyrtuar lexon ngjarjet e ruajtura dhe nuk e ndryshon projektin, nuk nis një transferim dhe nuk e debiton llogarinë. Dukshmëria mbi komponentët që shkruajnë ngjarje dhe testimi i llogarisë me autentikim mbeten pjesë e shqyrtimit ende në pritje të kontratës së funksionimit.