Доступ до облікового запису та проєкту
Використовуйте активований обліковий запис 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-адресою джерела запиту. Приклади не надсилають реального запиту, а успішна відповідь не доводить, що оператор прийняв або завершив перенесення номерів.
Наслідки виконання
Перевірений обробник читає збережені події та не змінює проєкт, не розпочинає перенесення номерів і не списує кошти з облікового запису. Перевірка видимості обробників запису подій і тестування облікового запису з автентифікацією залишаються частиною ще не завершеної перевірки контракту інтерфейсу.