Програмери

GET/v3/get_document_number_types/{country}

Списак типова бројева за регистрацију

Пронађите називе типова бројева који су тренутно заступљени у каталогу за регистрацију за одређену земљу.

На овој страници
  1. Изаберите тип према називу враћеном у одговору
  2. Број група не представља залиху телефонских бројева
  3. Захтев
  4. Одговор
  5. Грешке
  6. Доступност и споредни ефекти

Изаберите тип према називу враћеном у одговору

Користите земљу из get_document_countries. Проследите враћени назив типа функцији get_requirements. Идентификатор типа у каталогу није идентификатор префикса, броја нити категорије доказа.

Број група не представља залиху телефонских бројева

available_groups броји записе о групама враћене овим упитом каталога. Не броји телефонске бројеве доступне за куповину, не резервише залихе нити гарантује да су у каталогу обухваћене све странице из надређеног извора. Засебно претражите одговарајућу залиху бројева и прегледајте понуду.

Захтев

Користите приступне податке свог омогућеног API налога преко HTTPS-а. Подржани су Basic аутентификација и омогућени bearer токени API налога; примењују се ограничења налога.

GET са било којим документованим параметром у путањи URL-а.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_number_types/$COUNTRY_ISO"
Параметри путање
НазивТипОбавезноОпис
countrystringДаДвословни ISO код земље из каталога земаља за регистрацију. Уклањају се размаци на почетку и крају кода, а слова се претварају у велика.

Одговор

Проверите status.code у телу JSON одговора, као и HTTP статус. response је низ који садржи id, name и available_groups. Користите name као number_type при позивању get_requirements; немојте слати id уместо њега. available_groups је број записа о групама враћених за тај тип, а не број телефонских бројева на залихи нити укупан број са свих страница резултата. Типови за које није враћена ниједна група се изостављају. Предност у редоследу имају Local, Mobile, National, Toll Free, Shared Cost, Global, а затим следе остали називи из каталога.

Пример структуре одговора; не представља податке налога у реалном времену нити актуелну понуду.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

Грешке

  • 400: country is required: наведите ISO код земље за регистрацију.
  • 400: Invalid country ISO or no available DID registration country found: изаберите земљу из актуелног каталога за регистрацију; ово не потврђује да документи нису потребни.

Доступност и споредни ефекти

  • Овај упит каталога/захтева не креира идентитет, не отпрема доказ, не региструје број нити шаље поруџбину.
  • Успешан одговор каталога не представља одобрење ваших докумената нити потврду да изабрани број може да се активира.