Доступ к учётной записи и проекту
Используйте включённую учётную запись API через HTTPS с разрешённого IP-адреса. Проект должен принадлежать этой учётной записи и не должен быть удалён. Используйте уникальный идентификатор проекта из процесса заказа переноса номеров, а не его числовой идентификатор в базе данных или номер телефона. При формировании запроса применяйте URL-кодирование к идентификатору проекта.
Запрос
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Ответ
Вымышленный пример ответа.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response — это список. Существующий проект без номеров возвращает пустой список с кодом API 200 и значением status.results, равным 0. Несуществующие проекты, напротив, возвращают код API 404.
Поля номеров
| Поле | Значение |
|---|---|
| id, number, isocode | Числовой идентификатор строки, сохранённый текст телефонного номера и код страны. Идентификатор строки не является идентификатором проекта. |
| status, status_str | Числовой статус и его известная метка. |
| foc | Сохранённое значение планирования твёрдого обязательства по заказу. Оно может быть пустым; обработчик не преобразует его в документированный часовой пояс или формат временной метки. |
| updated, date_created, date_completed | Сохранённые значения обновления, создания и завершения. Явно обрабатывайте пустые значения; не предполагайте формат ISO8601 и не определяйте часовой пояс по вымышленному примеру. |
| comment | Сохранённый комментарий для клиента. Показывайте его как текст, а не как исполняемый HTML. |
Это представление данных не включает поле internal_comment, предназначенное только для сотрудников. Это не означает, что отдельный устаревший поиск одного номера использует такое же представление.
Порядок и мониторинг
Запрос сортирует результаты по возрастанию времени создания. Для строк с одинаковым временем создания никакой дополнительный порядок не гарантируется. Нет разбиения на страницы, инкрементального курсора или фильтра по дате. Прочитайте весь список для сверки данных проекта и не считайте его текущее количество строк постоянным каталогом.
Толкование статуса переноса
| Значение | Метка |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Сохраняйте числовой статус и учитывайте неизвестные значения. Для неизвестных меток используется сохранённое значение без гарантии новой метки. Сохранённый статус завершения или запланированная дата сами по себе не проверяют маршрутизацию входящих вызовов или все услуги номера.
Ошибки и ограничения
Проверяйте и ответ HTTP, и status.code/status.msg. Несуществующий, удалённый или не принадлежащий учётной записи проект возвращает код API 404 с сообщением о том, что проект не найден. Также действуют ограничения аутентификации и исходного IP-адреса. Примеры не выполняют реального запроса, а успешный ответ не доказывает, что оператор принял или завершил перенос.
Последствия
Проверенный обработчик только читает проект и его сохранённые строки номеров. Ответ — это снимок данных, а не подтверждение оператора или реальный тест услуги. Он не инициирует перенос, не меняет маршрутизацию и не списывает средства с учётной записи.