Juurdepääs kontole ja projektile
Kasutage lubatud IP-aadressilt aktiveeritud API kontot HTTPS ühenduse kaudu. Projekt peab kuuluma sellele kontole ega tohi olla kustutatud. Kasutage teisaldamistellimuse töövoost saadud projekti kordumatut tunnust, mitte selle arvulist andmebaasitunnust ega telefoninumbrit. Päringu koostamisel kodeerige projekti tunnus URL-i kodeerimisreeglite järgi.
Päring
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Vastus
Väljamõeldud vastuse näide.
{
"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"
}
]
}Olemasoleva sündmusteta projekti korral tagastatakse API kood 200, tühi loend ja status.results väärtusega 0. Tulemusi küsitakse loomise aja järgi kahanevas järjekorras; võrdsete aegade korral lisajärjestust ei määrata ning puuduvad lehekülgjaotus, kursor ja kuupäevafilter.
Lugege sündmuse andmesisu hoolikalt
id on sündmuserea arvuline tunnus, subject on selle salvestatud teema ning date_created on selle salvestatud kuupäeva ja kellaaja väärtus. Lõpp-punkt säilitab töötlemata event stringi ning püüab dekodeerida ka selle välju type, value ja source. Kui andmesisu ei ole JSON objekt või mõni atribuut puudub, on vastav parsitud väli tühi string.
Andmesisu ei ole fikseeritud loendväärtuste kogum ning selle lihtteksti skeem ei ole tagatud. Ärge käsitlege allikateksti kinnitatud identiteedina ega kuvage sündmuse sisu HTML-ina. Hoidke töötlemata sündmusi vastavate õigustega serveripoolsetes töövoogudes ning kuvage vastavate õigustega kasutajatele ainult sobivat teksti. Sellel lõpp-punktil puuduvad töötajate ja klientide jaoks eraldi sündmuste nähtavuse filter ning sisu varjamine.
Ajalugu ei taga kohaletoimetamist
See on salvestatud projektiajalugu, mitte veebihaakide voog, muutumatu sünkroonimiskursor ega kõigi andmebaasimuudatuste täielik kirje. Näiteks numbrite lisamine ülevaadatud numbrite lisamise töötleja kaudu ei loo iseenesest sündmust. Lisaks sündmuste lugemisele võrrelge ja kooskõlastage ka numbrite loend ning olekute kaupa loendatud arvud.
Vead ja piirangud
Kontrollige nii HTTP vastust kui ka välju status.code/status.msg. Kui projekt puudub, on kustutatud või ei kuulu kontole, tagastatakse API kood 404 koos teatega, et projekti ei leitud. Kehtivad ka autentimisnõuded ja lähte-IP piirangud. Näited ei tee tegelikku päringut ning edukas vastus ei tõenda, et sideoperaator on teisaldamise vastu võtnud või lõpetanud.
Toimingu mõju
Ülevaadatud töötleja loeb salvestatud sündmusi ega muuda projekti, alusta teisaldamist ega debiteeri kontot. Sündmusi kirjutavate komponentide nähtavuse ülevaatus ja konto testimine autentimisega kuuluvad endiselt pooleliolevasse liideselepingu ülevaatusse.