Прочитане на един закупен номер

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

Използване на резултата

Това е прочитане на запазени данни. То не купува номер, не одобрява документи за самоличност, не променя дестинация и не гарантира, че повикване, факс или съобщение ще бъде доставено. При конфигуриране на номер тествайте всяка активирана услуга поотделно.