Accesul la cont și la proiect
Folosiți un cont API activat, prin HTTPS, de la o adresă IP permisă. Proiectul trebuie să aparțină acelui cont și nu trebuie să fie șters. Folosiți identificatorul unic al proiectului din fluxul de comandă a portării, nu identificatorul numeric din baza de date sau un număr de telefon. La construirea unei cereri, aplicați codificarea URL identificatorului proiectului.
Cerere
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Răspuns
Exemplu fictiv de răspuns.
{
"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"
}
]
}Un proiect existent fără evenimente returnează codul API 200, o listă goală și status.results egal cu 0. Rezultatele sunt solicitate în ordinea descrescătoare a momentului creării, fără o ordonare suplimentară pentru momente identice, fără paginare, cursor sau filtru după dată.
Citiți cu atenție datele evenimentului
id este identificatorul numeric al rândului evenimentului, subject este subiectul său stocat, iar date_created este valoarea stocată a datei și orei sale. Punctul de acces păstrează șirul brut event și încearcă, de asemenea, să îi decodeze proprietățile type, value și source. Dacă datele evenimentului nu constituie un obiect JSON sau dacă lipsește o proprietate, câmpul corespunzător rezultat din analiză este un șir gol.
Datele evenimentului nu reprezintă o enumerare fixă și nici nu respectă în mod garantat o schemă de text simplu. Nu considerați textul sursei drept o identitate verificată și nu redați conținutul evenimentului ca HTML. Păstrați evenimentele brute în fluxuri autorizate de pe server și afișați utilizatorilor autorizați numai textul adecvat. Acest punct de acces nu are un filtru separat de vizibilitate a evenimentelor pentru personal și clienți și nu maschează conținutul.
Istoricul nu garantează livrarea
Acesta este istoricul stocat al proiectului, nu un flux de webhook-uri, un cursor de sincronizare imuabil sau o evidență completă a tuturor modificărilor din baza de date. De exemplu, adăugarea numerelor prin gestionarul analizat pentru adăugarea numerelor nu creează în sine un eveniment. Pe lângă consultarea evenimentelor, verificați concordanța listei de numere și a numărului de elemente pentru fiecare stare.
Erori și limite
Verificați atât răspunsul HTTP, cât și status.code/status.msg. Un proiect inexistent, șters sau care nu aparține contului returnează codul API 404 cu un mesaj care indică faptul că proiectul nu a fost găsit. Se aplică, de asemenea, cerințele de autentificare și restricțiile privind adresa IP sursă. Exemplele nu efectuează o cerere reală, iar un răspuns reușit nu dovedește că un operator a acceptat sau a finalizat un transfer.
Efecte
Gestionarul analizat citește evenimentele stocate și nu modifică proiectul, nu inițiază un transfer și nu debitează contul. Vizibilitatea asupra componentelor care scriu evenimente și testarea contului cu autentificare rămân parte a analizei în așteptare a contractului de funcționare.