Листа бројева у пројекту преноса

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

Користите омогућен 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 адресе. Примери не шаљу стварни захтев, а успешан одговор није доказ да је оператор прихватио или завршио пренос.

Ефекти

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