Прочитајте услове за регистрацију

Изаберите државу и тип броја

Изаберите државу регистрације, а затим употребите назив који враћа get_document_number_types. Пошаљите тај назив као number_type, а не идентификатор типа или општу категорију за претрагу бројева.

Прочитајте враћена упутства

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

Не тумачите грешку као ослобађање од обавезе регистрације

Грешка о неважећој држави или о томе да нема докумената за регистрацију у тој држави обједињује два услова. Она није доказ да регистрација није потребна. Неуспешна претрага или празан резултат такође не представљају одобрење корисника или броја. Обратите се подршци ако је резултат нејасан.

Захтев

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

POST са application/json или application/x-www-form-urlencoded.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  --request POST \
  --header "Content-Type: application/json" \
  --data '{"country":"US","number_type":"Local"}' \
  "https://api.multitel.net/v3/get_requirements"

Параметри тела захтева
Назив	Тип	Обавезно	Опис
`country`	ниска	Да	ISO ознака државе из get_document_countries.
`number_type`	ниска	Да	Назив типа из get_document_number_types, на пример Local; при упоређивању се не разликују велика и мала слова. Наведите назив, а не његов идентификатор.

Одговор

Проверите status.code у JSON телу, као и HTTP статус. response је један ресурс са условима који садржи id, type и attributes, уз relationships када се враћају. Идентификатори у ресурсу и подацима о везама су непрозирни и из њих не треба изводити значење. Из необавезног текста restriction_message уклоњене су HTML ознаке; преостали садржај обрађујте као текст, а не као поуздан HTML. Обрађивач враћа први ресурс са условима, па немојте закључити да је овај одговор исцрпна листа. Доступност атрибута и веза зависи од државе и типа; пример није потпуна, фиксна шема.

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

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "id": "REQUIREMENT_ID_FROM_RESPONSE",
    "type": "RESOURCE_TYPE_FROM_RESPONSE",
    "attributes": {
      "restriction_message": "Example country-specific instructions."
    }
  }
}

Грешке

400: Провера исправности државе и number_type није успела: наведите обе обавезне вредности. Текст провере може садржати форматирање.
400: Invalid country ISO or No country registration documents required.: ова двосмислена порука сама по себи не доказује ослобађање од обавезе регистрације.
400: Invalid number type: користите враћени назив типа. Стара порука о грешци наводи Global, Local, Mobile, National, Shared Cost и Toll Free.
500: Unable to load registration requirements for the specified country and number type.: услови нису успешно враћени. Покушајте поново касније или се обратите подршци.

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

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