Tilin ja projektin käyttöoikeudet
Käytä käytössä olevaa API-tiliä HTTPS-yhteyden kautta sallitusta IP-osoitteesta. Projektin on kuuluttava kyseiselle tilille, eikä se saa olla poistettu. Käytä numeronsiirtotilauksen työnkulusta saatua projektin yksilöllistä tunnistetta, älä sen numeerista tietokantatunnistetta tai puhelinnumeroa. URL-koodaa projektin tunniste pyyntöä muodostaessasi.
Pyyntö
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Vastaus
Kuvitteellinen vastausesimerkki.
{
"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"
}
]
}Olemassa oleva projekti, jolla ei ole tapahtumia, palauttaa API-koodin 200, tyhjän luettelon ja kentän status.results arvona 0. Tulokset pyydetään luontiajan mukaan laskevassa järjestyksessä ilman samanaikaisten tulosten lisäjärjestystä, sivutusta, kohdistinta tai päivämääräsuodatinta.
Lue tapahtuman tietosisältö huolellisesti
id on tapahtumarivin numeerinen tunniste, subject on sen tallennettu aihe ja date_created on sen tallennettu päivämäärä- ja aika-arvo. Rajapinnan päätepiste säilyttää raakamuotoisen event-merkkijonon ja yrittää myös purkaa siitä kentät type, value ja source. Jos tietosisältö ei ole JSON-objekti tai jokin ominaisuus puuttuu, vastaava jäsennetty kenttä on tyhjä merkkijono.
Tietosisältö ei ole kiinteä luettelotyyppi, eikä sen taata noudattavan pelkän tekstin skeemaa. Älä käsittele lähdetekstiä todennettuna henkilöllisyytenä äläkä esitä tapahtuman sisältöä HTML-muodossa. Säilytä raakamuotoiset tapahtumat käyttöoikeuksin suojatuissa palvelinpuolen työnkuluissa ja näytä vain asianmukaista tekstiä siihen oikeutetuille käyttäjille. Tässä päätepisteessä ei ole erillistä henkilöstön ja asiakkaiden tapahtumanäkyvyyden suodatusta eikä sisällön peittämistä.
Historia ei takaa toimitusta
Kyseessä on tallennettu projektihistoria, ei webhook-virta, muuttumaton synkronointikohdistin eikä täydellinen loki kaikista tietokannan muutoksista. Esimerkiksi numeroiden lisääminen tarkastetun numeroiden lisäyskäsittelijän kautta ei itsessään luo tapahtumaa. Täsmäytä myös numeroluettelo ja tilakohtaiset lukumäärät tapahtumien lukemisen lisäksi.
Virheet ja rajoitukset
Tarkista sekä HTTP-vastaus että status.code/status.msg. Puuttuva, poistettu tai tilille kuulumaton projekti palauttaa API-koodin 404 ja ilmoituksen, ettei projektia löytynyt. Myös todennusta ja lähde-IP-osoitetta koskevat rajoitukset ovat voimassa. Esimerkit eivät lähetä todellista pyyntöä, eikä onnistunut vastaus todista, että operaattori olisi hyväksynyt tai suorittanut numeronsiirron.
Vaikutukset
Tarkastettu käsittelijä lukee tallennettuja tapahtumia eikä muuta projektia, käynnistä numeronsiirtoa tai veloita tiliä. Näkyvyys tapahtumia kirjoittaviin komponentteihin ja todennettu tilitestaus kuuluvat edelleen keskeneräiseen rajapintasopimuksen tarkastukseen.