Читање једног купљеног броја

Прочитајте један запис о купљеном броју и његову сачувану конфигурацију. Ова операција враћа објекат уместо низа који враћа крајња тачка inventory.

Захтев

Користите API акредитиве на серверској страни преко HTTPS-а. Примери читају акредитиве из променљивих окружења; не садрже важеће акредитиве. Проверите status.code у телу JSON одговора, као и HTTP статус. Ови застарели обрађивачи не постављају увек HTTP статус грешке када дође до грешке у апликацији.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/numberinfo/12025550100"

Обавезни сегмент путање је сачувани међународни телефонски број, а не његов UUID или локал телефонске централе. Овај обрађивач не користи параметре упита нити тело захтева.

Одговор

Ово је илустративни пример структуре одговора, а не подаци налога или актуелна понуда цене.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550100",
    "uuid": "NUMBER_UUID",
    "description": "Main reception",
    "isocode": "US",
    "config": {
      "uri": "sip:reception@example.com",
      "uri2": "",
      "uri3": "",
      "forward_destination": "",
      "sms_uri": "",
      "sms_forward_destination": ""
    },
    "features": {
      "voice": "1",
      "sms": "1",
      "mms": "0"
    },
    "status": {
      "capacity": {
        "assigned_channels": "2",
        "used_channels": "0",
        "overflow": "0",
        "overage_charge": "0.01"
      },
      "origination": {
        "origination_trunk_id": "ORIGINATION_ID",
        "origination_trunk_name": "ORIGINATION_NAME",
        "origination_country_iso": "US",
        "origination_continent_iso": "NA",
        "origination_continent_name": "North America"
      },
      "service_active": "1",
      "force_codec": "",
      "force_dtmf": ""
    },
    "billing": {
      "cnam": "0",
      "overflow": "0",
      "autorenew": "1",
      "persistent": "0",
      "date_created": "2026-01-01 00:00:00"
    },
    "price": {
      "setup_price": "0.00",
      "monthly_price": "1.00",
      "per_minute": "0.01",
      "free_minutes": "0",
      "remaining_minutes": "0",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

Враћена поља броја
Поље	Значење
`number, uuid, description, isocode`	Сачувани телефонски број, идентификатор броја чија се унутрашња структура не тумачи, опис и ознака земље.
`config`	Сачувана поља одредишта за гласовне позиве, спољног прослеђивања, SMS одредишта и SMS прослеђивања. Ова крајња тачка их не мења.
`features`	Сачуване ознаке подршке за гласовне позиве, SMS и MMS. Није гарантовано да су застареле сачуване ознаке логичке вредности у JSON-у.
`status.capacity`	Вредности додељених и коришћених канала, подешавање прекорачења капацитета и сачувана накнада за прекорачење. Ово су сачувани метаподаци, а не нова понуда капацитета или провера позива уживо.
`status.origination`	Сачувани метаподаци о пореклу позива. Не тумачите унутрашњу структуру идентификатора; не изводите логику апликације из интерних назива.
`status.service_active, force_codec, force_dtmf`	Сачувана поља активације и конфигурације медија. Сама ознака не доказује успешну испоруку долазног саобраћаја.
`billing`	Сачуване вредности за CNAM, прекорачење капацитета, обнављање, трајност и креирање. Њихово читање не мења обнављање нити друга подешавања наплате.
`price`	Сачуване цене успостављања услуге, месечне цене и цене по минуту, као и квоте минута. Обрађивач не пружа поље валуте нити нову понуду. Не закључујте о валути на основу вредности из примера и не користите их као актуелну понуду за куповину.

У поређењу са inventory, ова крајња тачка такође враћа needs_registration, vrating, country_id, area_id, provider_id и price.perminute_charges. Ово су застареле сачуване вредности, а не засебан одговор о одобравању идентитета. Не треба тумачити унутрашњу структуру референтних идентификатора; без одговарајућег одговора за откривање података немојте на основу њих конструисати URL адресе за откривање података нити закључивати о повезаности са пружаоцима услуга.

Нема одговарајућег броја

Ако за аутентификовани налог није пронађен одговарајући запис који није поништен, тело JSON одговора садржи status.code 404 и поруку која садржи number not found. Не ослањајте се на суфикс поруке који означава линију изворног кода. Пре поновног покушаја проверите сачувани број и inventory.

Коришћење резултата

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