Достъп до акаунта и проекта
Използвайте активиран 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.