Toegang tot die rekening en projek
Gebruik 'n geaktiveerde API-rekening oor HTTPS vanaf 'n toegelate IP-adres. Die projek moet aan daardie rekening behoort en mag nie uitgevee wees nie. Gebruik die projek se unieke ID uit die werkvloei vir nommeroordragbestellings, nie sy numeriese databasis-ID of 'n telefoonnommer nie. Pas URL-kodering op die projek-ID toe wanneer jy 'n versoek saamstel.
Versoek
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Antwoord
Fiktiewe voorbeeld van 'n antwoord.
{
"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"
}
]
}Vir 'n bestaande projek sonder gebeure word API-kode 200, 'n leë lys en status.results gelyk aan 0 teruggestuur. Resultate word in dalende volgorde van skeppingstyd aangevra, sonder bykomende sortering vir gelyke tye, paginering, 'n wyser of 'n datumfilter.
Lees die gebeurtenisdata sorgvuldig
id is die numeriese ID van die gebeurtenisry, subject is die gestoorde onderwerp daarvan, en date_created is die gestoorde datum- en tydwaarde daarvan. Die eindpunt behou die rou event-string en probeer ook die volgende velde daarin dekodeer: type, value en source. As die gebeurtenisdata nie 'n JSON-objek is nie of 'n eienskap ontbreek, is die ooreenstemmende ontlede veld 'n leë string.
Die gebeurtenisdata is nie 'n vaste stel opgesomde waardes of 'n gewaarborgde skema vir gewone teks nie. Moenie bronteks as 'n geverifieerde identiteit beskou of gebeurtenisinhoud as HTML vertoon nie. Hou rou gebeure in gemagtigde werkvloeie aan die bedienerkant en wys slegs gepaste teks aan gemagtigde gebruikers. Hierdie eindpunt het geen afsonderlike filter vir die sigbaarheid van gebeure vir personeel en kliënte nie, en verberg ook nie sensitiewe inhoud nie.
Geskiedenis is nie 'n waarborg van aflewering nie
Dit is gestoorde projekgeskiedenis, nie 'n stroom webhaakgebeure, 'n onveranderlike sinchronisasiewyser of 'n volledige rekord van elke databasisverandering nie. Die byvoeging van nommers deur die nagegane hanteerder vir die byvoeging van nommers skep byvoorbeeld nie op sigself 'n gebeurtenis nie. Lees die gebeure en vergelyk ook die nommerlys en die tellings per status om hulle met mekaar te versoen.
Foute en beperkings
Kontroleer sowel die HTTP-antwoord as status.code/status.msg. Vir 'n projek wat ontbreek, uitgevee is of nie aan die rekening behoort nie, word API-kode 404 teruggestuur met 'n boodskap dat die projek nie gevind is nie. Outentiseringsvereistes en beperkings op die bron-IP-adres geld ook. Die voorbeelde stuur nie 'n werklike versoek nie, en 'n suksesvolle antwoord bewys nie dat 'n telekommunikasie-operateur 'n nommeroordrag aanvaar of voltooi het nie.
Uitwerking
Die nagegane hanteerder lees gestoorde gebeure en verander nie die projek, begin nie 'n nommeroordrag en debiteer nie die rekening nie. Die sigbaarheid van komponente wat gebeure skryf, en toetsing met 'n geoutentiseerde rekening, bly deel van die uitstaande hersiening van die gedragskontrak.