Pristup računu i projektu
Koristite omogućen API račun putem protokola HTTPS s dopuštene IP adrese. Projekt mora pripadati tom računu i ne smije biti izbrisan. Koristite jedinstveni identifikator projekta iz tijeka naručivanja prijenosa brojeva, a ne njegov brojčani identifikator u bazi podataka ili telefonski broj. Pri sastavljanju zahtjeva primijenite URL kodiranje na identifikator projekta.
Zahtjev
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Odgovor
Izmišljeni primjer odgovora.
{
"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"
}
]
}Postojeći projekt bez događaja vraća API kod 200, prazan popis i status.results s vrijednošću 0. Rezultati se traže silaznim redoslijedom prema vremenu stvaranja, bez dodatnog razvrstavanja za jednaka vremena, podjele na stranice, pokazivača ili filtra po datumu.
Pažljivo pročitajte podatke događaja
id je brojčani identifikator retka događaja, subject je njegov pohranjeni predmet, a date_created je njegova pohranjena vrijednost datuma i vremena. Krajnja točka čuva neobrađeni event niz znakova te također pokušava dekodirati njegova polja type, value i source. Ako podaci događaja nisu JSON objekt ili nedostaje neko svojstvo, odgovarajuće parsirano polje sadrži prazan niz znakova.
Podaci događaja nemaju fiksan skup dopuštenih vrijednosti ni zajamčenu shemu običnog teksta. Tekst izvora nemojte smatrati provjerenim identitetom niti sadržaj događaja prikazivati kao HTML. Neobrađene događaje zadržite u ovlaštenim tijekovima rada na poslužitelju, a ovlaštenim korisnicima prikazujte samo prikladan tekst. Ova krajnja točka nema zaseban filtar vidljivosti događaja za osoblje i korisnike niti prikrivanje sadržaja.
Povijest nije jamstvo isporuke
Ovo je pohranjena povijest projekta, a ne tok webhook događaja, nepromjenjivi pokazivač sinkronizacije ili potpuna evidencija svake promjene u bazi podataka. Primjerice, dodavanje brojeva putem pregledanog obrađivača za dodavanje brojeva samo po sebi ne stvara događaj. Uz čitanje događaja provjerite i uskladite popis brojeva i broj stavki po statusu.
Pogreške i ograničenja
Provjerite i HTTP odgovor i status.code/status.msg. Projekt koji ne postoji, koji je izbrisan ili koji ne pripada računu vraća API kod 404 s porukom da projekt nije pronađen. Primjenjuju se i zahtjevi autentifikacije te ograničenja izvornih IP adresa. Primjeri ne šalju stvarni zahtjev, a uspješan odgovor nije dokaz da je operator prihvatio ili dovršio prijenos brojeva.
Učinci
Pregledani obrađivač čita pohranjene događaje i ne mijenja projekt, ne pokreće prijenos brojeva niti tereti račun. Uvid u kod koji zapisuje događaje i testiranje računa uz autentifikaciju i dalje su dio predstojećeg pregleda API ugovora.