Изаберите тип према називу враћеном у одговору
Користите земљу из 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"| Назив | Тип | Обавезно | Опис |
|---|---|---|---|
country | string | Да | Двословни 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: изаберите земљу из актуелног каталога за регистрацију; ово не потврђује да документи нису потребни.
Доступност и споредни ефекти
- Овај упит каталога/захтева не креира идентитет, не отпрема доказ, не региструје број нити шаље поруџбину.
- Успешан одговор каталога не представља одобрење ваших докумената нити потврду да изабрани број може да се активира.