Prieiga prie paskyros ir projekto
Naudokite įjungtą API paskyrą ir junkitės per HTTPS iš leidžiamo IP adreso. Projektas turi priklausyti tai paskyrai ir negali būti ištrintas. Naudokite unikalų projekto identifikatorių iš numerių perkėlimo užsakymo proceso, o ne jo skaitinį duomenų bazės identifikatorių ar telefono numerį. Kurdami užklausą, projekto identifikatorių užkoduokite URL formatu.
Užklausa
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Atsakymas
Išgalvotas atsakymo pavyzdys.
{
"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"
}
]
}Jei esamas projektas neturi įvykių, grąžinamas API kodas 200, tuščias sąrašas ir status.results reikšmė lygi 0. Rezultatų prašoma mažėjančia sukūrimo laiko tvarka; papildomas rikiavimas, kai laikas sutampa, puslapiavimas, žymeklis ar datos filtras nenumatyti.
Atidžiai perskaitykite įvykio duomenis
id yra skaitinis įvykio eilutės identifikatorius, subject yra išsaugota jo tema, o date_created yra išsaugota jo datos ir laiko reikšmė. Galinis taškas išsaugo neapdorotą event eilutę ir taip pat bando iškoduoti joje esančius laukus type, value ir source. Jei duomenys nėra JSON objektas arba trūksta savybės, atitinkamas išanalizuotas laukas yra tuščia eilutė.
Įvykio duomenys nėra fiksuotas išvardijamų reikšmių rinkinys, o paprastojo teksto schema nėra garantuojama. Nelaikykite šaltinio teksto patvirtinta tapatybe ir neatvaizduokite įvykio turinio kaip HTML. Neapdorotus įvykius laikykite tik prieigos teisėmis apsaugotuose serverio procesuose, o atitinkamas teises turintiems naudotojams rodykite tik tinkamą tekstą. Šis galinis taškas neturi atskiro darbuotojams ir klientams skirtų įvykių matomumo filtro ar turinio maskavimo.
Istorija negarantuoja pristatymo
Tai išsaugota projekto istorija, o ne žiniatinklio pranešimų srautas, nekintamas sinchronizavimo žymeklis ar išsamus kiekvieno duomenų bazės pakeitimo žurnalas. Pavyzdžiui, numerių pridėjimas naudojant peržiūrėtą numerių pridėjimo apdorojimo funkciją savaime nesukuria įvykio. Be įvykių skaitymo, taip pat sutikrinkite numerių sąrašą ir skaičius pagal būsenas.
Klaidos ir apribojimai
Tikrinkite ir HTTP atsakymą, ir status.code/status.msg. Jei projektas neegzistuoja, yra ištrintas arba nepriklauso paskyrai, grąžinamas API kodas 404 su pranešimu, kad projektas nerastas. Taip pat taikomas autentifikavimas ir užklausos šaltinio IP adreso apribojimai. Pavyzdžiai nesiunčia tikros užklausos, o sėkmingas atsakymas neįrodo, kad operatorius priėmė arba užbaigė numerių perkėlimą.
Poveikis
Peržiūrėta apdorojimo funkcija skaito išsaugotus įvykius ir nekeičia projekto, nepradeda numerių perkėlimo ir nenurašo lėšų iš paskyros. Įvykius įrašančių funkcijų matomumo peržiūra ir paskyros bandymai su autentifikavimu tebėra nebaigtos sąsajos sutarties peržiūros dalis.