Достъп до акаунта и проекта
Използвайте активиран 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 адрес. Примерите не изпълняват реална заявка, а успешният отговор не доказва, че оператор е приел или завършил прехвърляне.
Ефекти
Прегледаната обработваща функция само чете проекта и съхранените му редове с номера. Отговорът е моментна снимка, а не потвърждение от оператор или тест на услугата на живо. Той не започва пренасяне, не променя маршрутизирането и не дебитира акаунта.