Hozzáférés a fiókhoz és a projekthez
Engedélyezett IP-címről, HTTPS kapcsolaton keresztül használjon egy aktív API-fiókot. A projektnek ehhez a fiókhoz kell tartoznia, és nem lehet törölt állapotú. A számhordozási megrendelés munkafolyamatából származó egyedi projektazonosítót használja, ne a projekt numerikus adatbázis-azonosítóját vagy egy telefonszámot. A kérés összeállításakor alkalmazzon URL-kódolást a projektazonosítóra.
Kérés
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Válasz
Kitalált válaszpélda.
{
"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"
}
]
}Egy létező, események nélküli projekt esetén a válaszban 200-as API-kód, üres lista és a következő mező szerepel: status.results, amelynek értéke 0. Az eredmények lekérése a létrehozási idő szerint csökkenő sorrendben történik; azonos időpontok esetére nincs további rendezés, és nincs lapozás, kurzor vagy dátumszűrő.
Körültekintően értelmezze az eseményadatokat
id az eseménysor numerikus azonosítója, subject a tárolt tárgya, date_created pedig a tárolt dátum- és időértéke. A végpont megőrzi a nyers event karakterláncot, és megkísérli dekódolni annak type, value és source tulajdonságait is. Ha az eseményadat nem JSON-objektum, vagy valamelyik tulajdonság hiányzik, a hozzá tartozó feldolgozott mező üres karakterlánc lesz.
Az eseményadatok nem alkotnak rögzített felsorolást, és nem követnek garantáltan egyszerű szöveges sémát. A forrás szövegét ne tekintse ellenőrzött személyazonosságnak, és az esemény tartalmát ne jelenítse meg HTML-ként. A nyers eseményeket kizárólag jogosultsággal védett szerveroldali munkafolyamatokban kezelje, és csak a megfelelő szöveget jelenítse meg az arra jogosult felhasználóknak. Ez a végpont nem biztosít külön eseményláthatósági szűrőt a munkatársak és az ügyfelek számára, és nem takarja ki az érzékeny tartalmakat.
Az előzmények nem garantálják a végrehajtást
Ez tárolt projektelőzmény, nem pedig webhook-eseményfolyam, megváltoztathatatlan szinkronizációs kurzor vagy az összes adatbázis-módosítás teljes nyilvántartása. Például a számok hozzáadása a felülvizsgált számhozzáadási kezelőn keresztül önmagában nem hoz létre eseményt. Az események olvasása mellett egyeztesse a számlistát és az állapotonkénti darabszámokat is.
Hibák és korlátozások
Ellenőrizze a HTTP-választ, valamint a következő mezőket is: status.code/status.msg. Ha a projekt nem létezik, törölték, vagy nem az adott fiókhoz tartozik, a válasz 404-es API-kódot és a projekt hiányát jelző üzenetet tartalmaz. A hitelesítési követelmények és a forrás-IP-címre vonatkozó korlátozások szintén érvényesek. A példák nem küldenek éles kérést, és a sikeres válasz nem bizonyítja, hogy egy szolgáltató elfogadta vagy befejezte a számhordozást.
Hatások
A felülvizsgált kezelő a tárolt eseményeket olvassa, és nem módosítja a projektet, nem indít számhordozást, és nem terheli meg a fiókot. Az eseményírók láthatóságának felülvizsgálata és a hitelesített fiókkal végzett tesztelés továbbra is a függőben lévő működési szerződésfelülvizsgálat részét képezi.