Список категорій підтвердних документів

Виберіть категорію підтвердного документа

Використовуйте повернуту категорію та тип суб’єкта, готуючи підтвердні документи, необхідні для ідентифікаційного запису. Цей список описує категорії, а не завантажені вами файли, і не означає схвалення жодного підтвердного документа.

Дотримуйтеся чинних вимог

Наявність категорії у списку не означає, що вона відповідає вимогам для кожної країни, типу номера чи ідентифікаційного запису клієнта. Перш ніж завантажувати підтвердні документи, ознайомтеся з відповідними вимогами та не інтерпретуйте внутрішню структуру повернутих ідентифікаторів.

Запит

Використовуйте облікові дані свого активованого облікового запису 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 на наявність помилок автентифікації або сервісу. Успішне повернення порожнього каталогу не означає схвалення документа чи звільнення від реєстрації.

Доступність і побічні ефекти

• Цей пошук у каталозі та вимогах не створює ідентифікаційного запису, не завантажує підтвердного документа, не реєструє номера й не оформлює замовлення.
• Успішна відповідь каталогу не означає схвалення ваших документів чи підтвердження того, що вибраний номер можна активувати.