Програмери

GET/v3/lnp/project/{uniqueid}/events

Читање догађаја пројекта преноса бројева

Преузмите сачувану историју пројекта и обрадите необрађене или неисправно обликоване податке догађаја.

На овој страници
  1. Приступ налогу и пројекту
  2. Захтев
  3. Одговор
  4. Пажљиво читајте податке догађаја
  5. Историја није гаранција испоруке
  6. Грешке и ограничења
  7. Ефекти

Приступ налогу и пројекту

Користите омогућен API налог преко HTTPS са дозвољене IP адресе. Пројекат мора припадати том налогу и не сме бити обрисан. Користите јединствени идентификатор пројекта из поступка наручивања преноса бројева, а не његов нумерички идентификатор у бази података нити телефонски број. При састављању захтева примените URL кодирање на идентификатор пројекта.

Захтев

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"

Одговор

Измишљени пример одговора.

{
  "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"
    }
  ]
}

За постојећи пројекат без догађаја враћају се API код 200, празна листа и status.results са вредношћу 0. Резултати се захтевају у опадајућем редоследу према времену настанка, без додатног сортирања када су времена једнака, пагинације, курсора или филтера по датуму.

Пажљиво читајте податке догађаја

id је нумерички идентификатор реда догађаја, subject је његов сачувани наслов, а date_created је његова сачувана вредност датума и времена. Крајња тачка чува необрађени event стринг и такође покушава да декодира његова поља type, value и source. Ако подаци нису JSON објекат или неко својство недостаје, одговарајуће парсирано поље је празан стринг.

Подаци догађаја нису фиксни набројиви тип нити гарантовано прате шему обичног текста. Немојте сматрати текст извора потврђеним идентитетом нити приказивати садржај догађаја као HTML. Необрађене догађаје задржите у овлашћеним поступцима на страни сервера, а овлашћеним корисницима приказујте само одговарајући текст. Ова крајња тачка нема засебан филтер видљивости догађаја за особље и клијенте нити прикрива садржај.

Историја није гаранција испоруке

Ово је сачувана историја пројекта, а не ток вебхук обавештења, непроменљиви курсор за синхронизацију или потпуна евиденција сваке промене у бази података. На пример, додавање бројева преко прегледаног обрађивача за додавање бројева само по себи не ствара догађај. Поред читања догађаја, усклађујте и листу бројева и бројеве ставки по статусима.

Грешке и ограничења

Проверите и HTTP одговор и status.code/status.msg. За пројекат који не постоји, који је обрисан или који не припада налогу враћа се API код 404 са поруком да пројекат није пронађен. Важе и захтеви за аутентификацију и ограничења изворне IP адресе. Примери не шаљу стварни захтев, а успешан одговор није доказ да је оператор прихватио или завршио пренос.

Ефекти

Прегледани обрађивач чита сачуване догађаје и не мења пројекат, не покреће пренос нити задужује налог. Видљивост догађаја које уписују компоненте за упис и тестирање налога уз аутентификацију и даље су део предстојећег прегледа уговора о понашању API-ја.