Разработчици

GET/v3/get_proof_types

Списък на категориите доказателства

Намерете идентификаторите на категориите доказателства и типовете субекти, преди да подготвите доказателства за самоличност или адрес.

На тази страница
  1. Изберете категория доказателства
  2. Съобразете доказателствата с действителните изисквания
  3. Заявка
  4. Отговор
  5. Грешки
  6. Достъпност и странични ефекти

Изберете категория доказателства

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

Съобразете доказателствата с действителните изисквания

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

Заявка

Използвайте данните за достъп на активирания си API акаунт през HTTPS. Поддържат се основно удостоверяване и активирани токени на приносител за API акаунта; прилагат се ограниченията на акаунта.

GET с всеки документиран параметър в URL пътя.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_proof_types"

Отговор

Проверете status.code в JSON тялото, както и HTTP статуса. response е масив от обекти с полета id, name и entity_type. Тези стойности идват от текущия каталог на доказателствата. Идентификаторите са непрозрачни стойности; копирайте ги, вместо да ги съставяте или изчислявате чрез хеширане. При успешна заявка може да бъде върнат празен каталог. Не задавайте твърдо в кода пълен списък на типовете субекти въз основа на този пример.

Примерна структура на отговора; не представлява данни за акаунта в реално време или актуална ценова оферта.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "PROOF_TYPE_ID_FROM_RESPONSE",
      "name": "Example proof category",
      "entity_type": "ENTITY_TYPE_FROM_RESPONSE"
    }
  ]
}

Грешки

  • Проверете status.code и status.msg за грешки при удостоверяването или грешки в услугата. Успешният отговор с празен каталог не представлява одобрение на документ или освобождаване от задължението за регистрация.

Достъпност и странични ефекти

  • Тази справка в каталога и изискванията не създава самоличност, не качва доказателство, не регистрира номер и не подава поръчка.
  • Успешният отговор с каталог не представлява одобрение на вашите документи или потвърждение, че избраният номер може да бъде активиран.