# Получение данных Пользователя

{% hint style="info" %}
Для того, чтобы воспользоваться услугами Aitu Passport для получения данных необходимо чтобы Партнер:

* был зарегистрирован в соответствующем окружении Aitu Passport (на тестовой площадке, на продакшн площадке)
* создал свой сервис в соответствующем окружении Aitu Passport
* подключил к своему сервису все необходимые сервисы (scope) Aitu Passport, предоставляющие доступ к данным Пользователя 
  {% endhint %}

## Схема получения данных пользователя в Aitu Passport 

Схема процесса получения данных пользователя из Aitu Passport выглядит следующим образом:

<figure><img src="/files/yPvUKcQkh9EI1qrslUCS" alt=""><figcaption></figcaption></figure>

## Описание процесса получения данных пользователя из AituPassport

1. Пользователь инициирует процесс авторизации с помощью Aitu Passport в приложении Партнера (нажимает на кнопку или ссылку в приложении Партнера). Стрелка 1 на [схеме](/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md#skhema-polucheniya-dannykh-polzovatelya-v-aitu-passport).
2. В случае, если по условиям договора на оказание услуг Aitu Passport, номер мобильного телефона Пользователя верифицирует:

   * **Партнер** самостоятельно, то приложение Партнера должно в ссылке-запросе авторизации ([oauth2/auth](https://docs.passport.aitu.io/#operation/oauthAuth)) передать параметр `otp_confirmation`. Чтобы получить значение для параметра `otp_confirmation`**,** приложение Партнера должно вызвать метод [api/v1/trusted-phone](https://docs.passport.aitu.io/#operation/createTrustedPhone). Значение для параметра `otp_confirmation` передается в параметре `secret` ответа метода [api/v1/trusted-phone](https://docs.passport.aitu.io/#operation/createTrustedPhone).  **Внимание!** `secret`, а соответственно и значение в параметре `otp_confirmation` является одноразовым, его необходимо получать для каждого запроса авторизации заново!&#x20;
   * **Aitu Passport**, то параметр `otp_confirmation` в ссылке-запросе на авторизацию ([oauth2/auth](https://docs.passport.aitu.io/#operation/oauthAuth)) не передается, метод [api/v1/trusted-phone](https://docs.passport.aitu.io/#operation/createTrustedPhone) вызывать не нужно.&#x20;

   Процесс получения значения для параметра `otp_confirmation` обозначен стрелками 2 и 3 на [схеме](/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md#skhema-polucheniya-dannykh-polzovatelya-v-aitu-passport).

{% hint style="danger" %}
**Обратите внимание:**

* Срок жизни OTP - 330 секунд
* Максимальное количество попыток ввода OTP = 5, если они исчерпаны нужно запросить новый OTP;
* OTP допускается запрашивать раз в две минуты
* Количество раз отправки SMS c OTP не ограничено
  {% endhint %}

3. Партнер генерирует ссылку-запрос авторизации. Стрелка 4 на [схеме](/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md#skhema-polucheniya-dannykh-polzovatelya-v-aitu-passport). О том, как сгенерировать ссылку-запрос авторизации и как происходит процесс авторизации см. статью "Авторизация" -> глава "[Авторизация в Aitu Passport](/aituapps/aitu-passport/integraciya-s-aitu-passport/avtorizaciya.md#avtorizaciya-v-aitu-passport)"
4. Пользователю отображается стартовая страница Aitu Passport c запросом на подтверждение предоставления данных приложению Партнера. Стрелки 5 и 6 на [схеме](/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md#skhema-polucheniya-dannykh-polzovatelya-v-aitu-passport).
5. Пользователь разрешает доступ к данным, проходит процессы авторизации, идентификации в Aitu Passport. Путь пользователя в Aitu Passport определяется параметрами переданными в ссылке-запросе авторизации и кодами услуг Aitu Passport переданными в параметре scope. Стрелки 8 - 46 на [схеме](/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md#skhema-polucheniya-dannykh-polzovatelya-v-aitu-passport).

{% hint style="warning" %}
Для успешного прохождения этапа биометрической идентификации скорость подключения устройства Пользователя к сети интернет должна быть не менее 100кб/сек
{% endhint %}

6\. Aitu Passport генерирует код авторизации и передает его приложению Партнера. Описание данного процесса см. в статье "Авторизация" -> глава "[Авторизация в Aitu Passport](/aituapps/aitu-passport/integraciya-s-aitu-passport/avtorizaciya.md#avtorizaciya-v-aitu-passport). Стрелки 47 и 48 на [схеме](/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md#skhema-polucheniya-dannykh-polzovatelya-v-aitu-passport).

7\. Приложение Партнера (серверная часть приложения) обменивает полученный код авторизации на токены (access\_token, id\_token). Описание данного процесса см. в статье "Авторизация" -> глава "[Авторизация в Aitu Passport](/aituapps/aitu-passport/integraciya-s-aitu-passport/avtorizaciya.md#avtorizaciya-v-aitu-passport). Стрелки 49 и 50 на [схеме](/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md#skhema-polucheniya-dannykh-polzovatelya-v-aitu-passport)

### Сроки действия объектов

{% hint style="warning" %}
**Внимание:**

* Параметр `otp_confirmation`  действителен в течение **60 минут** с момента генерации;&#x20;
* Код авторизации (code) действителен  в течение **5 минут** с момента генерации;
* Токен авторизации (access\_token ) действителен в течение **30 дней** с момента генерации;
* Токен пользователя на устройстве действителен **1 год** с момента генерации.
  {% endhint %}

## Получение данных Пользователя

### Текстовые данные

В ответе на запрос получения токенов, см., на [схеме](/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md#skhema-polucheniya-dannykh-polzovatelya-v-aitu-passport) стрелки 49 и 50,  помимо access\_token приложение Партнера получает текстовые данные Пользователя в параметре id\_token.&#x20;

Параметр id\_token представляет собой jwt-токен и содержит в себе все текстовые данные Пользователя, которые были запрошены в ссылке-запросе на авторизацию в параметре scope. Для того чтобы извлечь текстовые данные пользователя из id\_token вы можете воспользоваться <https://jwt.io/>, так же на данном сайте описано, как данный jwt-токен можно распарсить в коде.

#### Структура текстовых данных, передаваемых в id\_token:

{% hint style="info" %}
Символом **\*** отмечены параметры, передающиеся только для резидентов РК
{% endhint %}

<table><thead><tr><th width="290.2886125859479">Параметр</th><th width="150">Тип</th><th width="344.4854368932039">Описание</th></tr></thead><tbody><tr><td><strong>first_name*</strong></td><td>string</td><td><p>Имя Пользователя.</p><p>Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code> передано значение <code>first_name</code> </p></td></tr><tr><td><strong>last_name*</strong></td><td>string</td><td><p>Фамилия  Пользователя. </p><p>Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code> передано значение <code>last_name</code></p></td></tr><tr><td><strong>middle_name*</strong></td><td>string</td><td><p>Отчество Пользователя. </p><p>Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code> передано значение <code>middle_name</code> и Пользователь указал отчество</p></td></tr><tr><td><strong>birth_date*</strong></td><td>string</td><td><p>Дата рождения Пользователя. </p><p>Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code> передано значение <code>birth_date</code></p></td></tr><tr><td><strong>gender*</strong></td><td>string</td><td><p>Пол Пользователя. </p><p>Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code> передано значение <code>gender</code></p></td></tr><tr><td><strong>nickname</strong></td><td>string</td><td>nickname (псевдоним) Пользователя. Передается если в ссылке-запросе авторизации, в параметре <code>scope</code> передано значение <code>nickname</code></td></tr><tr><td><strong>id_card_manual*</strong></td><td>object</td><td>Объект, содержащий данные документа, удостоверяющего личность Пользователя. Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code>,  передано значение <code>id_card_manual</code>. <a href="#struktura-obektov">Структура объекта</a></td></tr><tr><td><strong>residence_permit_manual*</strong></td><td>object</td><td>Объект, содержащий данные документа, вида на жительство Пользователя. Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code>,  передано значение <code>residence_permit_manual</code>. <a href="#struktura-obektov">Структура объекта</a> </td></tr><tr><td><strong>identification_document_manual*</strong></td><td>object</td><td>Объект, содержащий данные документа, удостоверяющего личность Пользователя. Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code>,  передано значение <code>identification_document_manual</code>. <a href="#struktura-obektov">Структура объекта</a></td></tr><tr><td><strong>identification_document_ocr*</strong></td><td>object</td><td>Объект, содержащий данные документа, удостоверяющего личность Пользователя. Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code>,  передано значение <code>identification_document_ocr</code>. <a href="#struktura-obektov">Структура объекта</a></td></tr><tr><td><strong>identification_document_mrz*</strong></td><td>object</td><td>Объект, содержащий данные документа, удостоверяющего личность Пользователя. Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code>,  передано значение <code>identification_document_mrz</code>. <a href="#struktura-obektov">Структура объекта</a></td></tr><tr><td><strong>residence_address_manual</strong></td><td>object</td><td>Объект, содержащий адрес фактического проживания Пользователя на территории РК. Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code>,  передано значение <code>residence_address_manual</code>. <a href="#struktura-obektov-residence_address_manual">Структура объекта</a></td></tr><tr><td><strong>registration_address_manual</strong></td><td>object</td><td>Объект, содержащий адрес регистрации Пользователя на территории РК. Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code>,  передано значение <code>registration_address_manual</code>. <a href="#struktura-obektov-residence_address_manual">Структура объекта</a></td></tr><tr><td><strong>phone</strong></td><td>string</td><td><p>Номер мобильного телефона Пользователя. </p><p>Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code> передано значение <code>phone</code></p></td></tr><tr><td><strong>sub</strong></td><td>string</td><td>Идентификатор Пользователя в AituPasport, передается всегда. В параметра <code>scope</code> передано значение <code>openid</code></td></tr><tr><td><strong>idpc_verification*</strong></td><td>object</td><td><p>Объект, который содержит данные полученные из ЦОИД при идентификации Пользователя. </p><p><a href="#struktura-obekta-idpc_verification">Структура объекта</a></p></td></tr><tr><td><strong>liveness_3d</strong></td><td>object</td><td><p>Объект, который содержит данные прохождения 3D Liveness. </p><p><a href="#struktura-obekta-liveness_3d">Структура объекта</a></p></td></tr><tr><td><strong>allowed</strong></td><td>boolean</td><td><p>Согласие пользователя на получение данных, совершение действий в кошельке Aitu Wallet 2.0. </p><p>True - Пользователь дал разрешение. False - Пользователь не дал разрешение. </p><p>Передается, если в ссылке-запросе авторизации, в параметре <code>scope</code> передано одно или несколько значений из списка: <code>wallet_read, wallet_pay, wallet_history</code></p></td></tr><tr><td><strong>non_resident_data</strong></td><td>object</td><td>Объект, в котором содержатся данные нерезидента РК. <a href="#struktura-obekta-non_resident_data">Структура объекта</a></td></tr><tr><td><strong>biometryQr</strong></td><td>boolean</td><td><p>Параметр передается равный TRUE если в процессе биометрической идентификации пользователю был показан QR-код со ссылкой для прохождения биометрии на другом устройстве И пользователь прошел биометрию на другом устройстве.</p><p>QR-код отображается если отсутствует доступ к камере на начальном устройстве, на котором пользователь начал проходить биометрию.</p></td></tr><tr><td><strong>gov_doc_verification</strong></td><td>object</td><td>Объект содержит данные удостоверения личности гражданина РК/вида на жительство иностранца выданного РК для скоупа (услуги) gov_doc_verification. Передается только в том случае, если биометрическая идентификация была пройдена Пользователем успешно. <a href="#struktura-obekta-gov_doc_verification-dlya-skoup-gov_doc_verification">Структура объекта</a></td></tr><tr><td><strong>confidence_level</strong></td><td>object</td><td>Объект содержит данные о результате прохождения биометрии для скоупа (услуги) gov_doc_verification. Передается всегда если в запросе авторизации вместе со скоуп gov_doc_verification передан параметр allow_face_match_failure = True (разрешено успешно завершать оAuth сессию и передавать ключ авторизации вне зависимости от результатов биометрической идентификации). <a href="#struktura-obekta-confidence_level-dlya-skoup-gov_doc_verification">Структура объекта</a></td></tr></tbody></table>

#### **Структура объектов:**&#x20;

* #### **id\_card\_manual,** &#x20;
* #### **residence\_permit\_manual,**&#x20;
* #### **identification\_document\_manual,**&#x20;
* #### &#x20;**identification\_document\_ocr,** &#x20;
* #### **identification\_document\_mrz**
* **international\_passport\_manual\_3d\_verification**

<table><thead><tr><th width="165.33333333333331">Параметр</th><th width="150">Required</th><th width="150">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><strong>name</strong></td><td>Required</td><td>string</td><td>Наименование параметра</td></tr><tr><td><strong>value</strong></td><td>Required</td><td>string</td><td>Значение параметра</td></tr><tr><td><strong>modified</strong></td><td>Required</td><td>string</td><td>Признак изменения параметра</td></tr></tbody></table>

**Список параметров объектов:**

* **id\_card\_manual,**
* **residence\_permit\_manual,**&#x20;
* **identification\_document\_manual,**&#x20;
* **identification\_document\_ocr**
* **international\_passport\_manual\_3d\_verification**

| Значение поля name | Описание                                 |
| ------------------ | ---------------------------------------- |
| **idCardNumber**   | Номер документа                          |
| **iin**            | ИИН                                      |
| **lastName**       | Фамилия                                  |
| **firstName**      | Имя                                      |
| **patronymic**     | Отчество                                 |
| **dateOfBirth**    | Дата рождения                            |
| **placeOfBirth**   | Место рождения                           |
| **nation**         | Национальность                           |
| **authority**      | Орган, выдавший документ                 |
| **issueDate**      | Дата выдачи документа                    |
| **expireDate**     | Дата завершения срока действия документа |

**Список параметров объекта - identification\_document\_mrz**

| Значение поля name | Описание                                 |
| ------------------ | ---------------------------------------- |
| **idCardNumber**   | Номер документа                          |
| **iin**            | ИИН                                      |
| **lastName**       | Фамилия                                  |
| **firstName**      | Имя                                      |
| **patronymic**     | Отчество                                 |
| **dateOfBirth**    | Дата рождения                            |
| **placeOfBirth**   | Место рождения                           |
| **nation**         | Национальность                           |
| **expireDate**     | Дата завершения срока действия документа |

#### **Структура объектов:**&#x20;

* **residence\_address\_manual,**
* &#x20;**registration\_address\_manual**

<table><thead><tr><th width="268">Параметр</th><th width="150">Required</th><th width="150">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><strong>country</strong></td><td>Required</td><td>string</td><td>Наименование страны</td></tr><tr><td><strong>countryRu</strong></td><td>Required</td><td>string</td><td>Наименование страны на русском языке</td></tr><tr><td><strong>countryEng</strong></td><td>Required</td><td>string</td><td>Наименование страны на английском языке</td></tr><tr><td><strong>countryKz</strong></td><td>Required</td><td>string</td><td>Наименование страны на казахском языке</td></tr><tr><td><strong>republicRu</strong></td><td>Required</td><td>string</td><td>Область или город республиканского значения на русском языке</td></tr><tr><td><strong>regionRu</strong></td><td>Required</td><td>string</td><td>Район или городская администрация на русском языке</td></tr><tr><td><strong>districtRu</strong></td><td>Optional</td><td>string</td><td>Город (район города) или иные поселения на русском языке</td></tr><tr><td><strong>districtAdministrationRu</strong></td><td>Optional</td><td>string</td><td>Город, городская (районная) администрация или сельский округ на русском языке</td></tr><tr><td><strong>republicKz</strong></td><td>Required</td><td>string</td><td>Область или город республиканского значения на казахском  языке</td></tr><tr><td><strong>regionKz</strong></td><td>Required</td><td>string</td><td>Район или городская администрация на казахском  языке</td></tr><tr><td><strong>districtKZ</strong></td><td>Optional</td><td>string</td><td>Город (район города) или иные поселения на казахском  языке</td></tr><tr><td><strong>districtAdministrationKz</strong></td><td>Optional</td><td>string</td><td>Город, городская (районная) администрация или сельский округ на казахском  языке</td></tr><tr><td><strong>street</strong></td><td>Required</td><td>string</td><td>Улица</td></tr><tr><td><strong>building</strong></td><td>Required</td><td>string</td><td>Номер дома</td></tr><tr><td><strong>buildingAdditionalNumber</strong></td><td>Optional</td><td>string</td><td>Дополнительный номер дома, например номер корпуса</td></tr><tr><td><strong>flat</strong></td><td>Optional</td><td>string</td><td>Номер квартиры</td></tr><tr><td><strong>catfCode</strong></td><td>Required</td><td>string</td><td>Код</td></tr></tbody></table>

#### **Структура объекта: “idpc\_verification”**

<table><thead><tr><th width="150">Параметр</th><th width="150">Required</th><th width="150">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><strong>iin</strong></td><td>Required</td><td>string</td><td>ИИН пользователя, полученный из ЦОИД</td></tr><tr><td><strong>requestId</strong></td><td>Required</td><td>string</td><td>Уникальный идентификатор запроса, полученный из ЦОИД</td></tr></tbody></table>

#### **Структура объекта: “liveness\_3d”**

<table><thead><tr><th width="150">Параметр</th><th width="150">Required</th><th width="150">Тип</th><th>Описание</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>verified</strong></td><td>Required</td><td>boolean</td><td><p>Признак прохождения 3D Liveness (определения живости лица). Может принимать значения:</p><ul><li>true - прошел успешно</li><li>false - не прошел</li></ul></td><td></td></tr></tbody></table>

#### Структура объекта: "**non\_resident\_data**"

<table><thead><tr><th width="197">Параметр</th><th width="120">Required</th><th width="89">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>documentNumber</td><td>Optional</td><td>string</td><td>Номер документа нерезидента РК (номер паспорта)</td></tr><tr><td>iin</td><td>Optional</td><td>string</td><td>ИИН, передается при наличии</td></tr><tr><td>firstName</td><td>Required</td><td>string</td><td>Имя</td></tr><tr><td>middleName</td><td>Optional</td><td>string</td><td>Отчество, передается при наличии</td></tr><tr><td>lastName</td><td>Required</td><td>string</td><td>Фамилия</td></tr><tr><td>dateOfBirth</td><td>Required</td><td>date</td><td>Дата рождения</td></tr><tr><td>nation</td><td>Required</td><td>string</td><td>Страна выдачи документа (паспорта). Передается в виде ISO 3166-1 alpha-2</td></tr><tr><td>authority</td><td>Required</td><td>string</td><td>Орган выдавший документ (паспорт)</td></tr><tr><td>issueDate</td><td>Required</td><td>date</td><td>Дата выдачи документа (паспорта)</td></tr><tr><td>expireDate</td><td>Required</td><td>date</td><td>Дата завершения срока действия документа (паспорта)</td></tr></tbody></table>

#### Структура объекта gov\_doc\_verification для скоуп gov\_doc\_verification

<table><thead><tr><th width="191.57012939453125">Параметр</th><th width="105.504150390625">Required</th><th width="104.4852294921875">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>documentNumber</td><td>Optional</td><td>string</td><td>Номер документа</td></tr><tr><td>iin</td><td>Optional</td><td>string</td><td>ИИН</td></tr><tr><td>firstName</td><td>Optional</td><td>string</td><td>Имя</td></tr><tr><td>middleName</td><td>Optional</td><td>string</td><td>Отчество</td></tr><tr><td>lastName</td><td>Optional</td><td>string</td><td>Фамилия</td></tr><tr><td>dateOfBirth</td><td>Optional</td><td>string</td><td>Дата рождения</td></tr><tr><td>placeOfBirth</td><td>Optional</td><td>string</td><td>Мессто рождения</td></tr><tr><td>nation</td><td>Optional</td><td>string</td><td>Гражданство</td></tr><tr><td>authority</td><td>Optional</td><td>string</td><td>Орган, выдавший документ</td></tr><tr><td>issueDate</td><td>Optional</td><td>string</td><td>Дата выдачи документа</td></tr><tr><td>expireDate</td><td>Optional</td><td>string</td><td>Дата завершения срока действия документа </td></tr></tbody></table>

{% hint style="warning" %}
Если вы тестируете оказание услуг по скоуп  gov\_doc\_verification (то есть работаете с тестовой площадкой AituPassport) то вам нужно предоставить ИИН и номер мобильного телефона сотрудника который будет проводить тестирование для того чтобы добавить его данные на тестовую площадку гос., систем (тестовую БМГ, тестовую ГБД ФЛ)
{% endhint %}

#### Структура объекта confidence\_level для скоуп gov\_doc\_verification

<table><thead><tr><th width="220.02728271484375">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td>faceMatch</td><td><p>Параметр, определяющий прохождение биометрии:</p><ul><li>VERIFIED - биометрия пройдена успешно</li><li>LOW_SIMILARITY - биометрия не пройдена</li></ul><p>Например, "faceMatch":"VERIFIED"</p></td></tr><tr><td>confidenceLevel</td><td>Коэффициент схожести полученный при прохождении биометрии. Например, "confidenceLevel":0.84349,</td></tr><tr><td>referenceConfidenceLevel</td><td>Эталонный коэффициент схожести. Например, "referenceConfidenceLevel":0.55</td></tr></tbody></table>

### Получение бинарных данных

Под получением бинарных данных подразумевается получение Партнером фото и видео материалов, сформированных Aitu Passport в процессе авторизации и идентификации Пользователя на платформе Aitu Passport.

Для получения бинарных данных в запрос, на получение этих данных, приложение Партнера должно передать Access token, в ответ Aitu Passport вернет запрашиваемые данные см., на [схеме](/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md#skhema-polucheniya-dannykh-polzovatelya-v-aitu-passport) стрелки 19 и 20.

#### Получение фото лица Пользователя - 2D биометрическая идентификация

Получить фото лица Пользователя, сформированного при 2D биометрической идентификации можно только в том случае, если в ссылке-запросе авторизации, в параметре scope было передано значение **liveness**

**api/v1/liveness/photo** - метод получения фото лица, сформированного при 2D биометрической идентификации, описание метода см. [здесь](https://docs.passport.aitu.io/#operation/getLivenessPhoto)

#### Получение фото лица Пользователя - 3D биометрическая идентификация

Получить фото лица Пользователя, сформированного при 3D биометрической идентификации можно только в том случае, если в ссылке-запросе авторизации, в параметре scope было передано значение **liveness\_3d**

**api/v1/liveness-3d/photo** - метод получения фото лица, сформированного при 3D биометрической идентификации, описание метода см. [здесь](https://docs.passport.aitu.io/#operation/getLiveness3DPhoto)

#### Получение фотографии документа, удостоверяющего  личность Пользователя - документ загружен Пользователем самостоятельно&#x20;

Получить фотографию документа, удостоверяющего личность Пользователя, которую пользователь загрузил самостоятельно в Aitu Passport можно только в том случае, если в ссылке-запросе авторизации, в параметре scope было передано одно из следующих значений:&#x20;

* **id\_card\_manual**
* **residence\_permit\_manual**
* **identification\_document\_manual**
* **identification\_document\_ocr**

**api/v1/documents/manual/photos** - метод получения фотографии документа, удостоверяющего личность Пользователя, которую пользователь загрузил самостоятельно, описание метода см. [здесь](https://docs.passport.aitu.io/#operation/getManuallyUploadedDocumentPhotos)

#### Получение фотографии документа, удостоверяющего личность Пользователя, загруженного Пользователем самостоятельно - распознавание документа по MRZ

Получить фотографию документа, удостоверяющего личность пользователя, загруженного Пользователем самостоятельно, где распознавание данных с документа производилось через MRZ можно только в том случае, если в ссылке-запросе авторизации, в параметре scope было передано значение **identification\_document\_mrz** \
\
**api/v1/documents/mrz/photo** - метод получения фотографии документа, удостоверяющего личность Пользователя, которую пользователь загрузил самостоятельно, описание метода см. [здесь](https://docs.passport.aitu.io/#operation/getUploadedDocumentMrzPhotos)

#### Получение видео-записи, снятой в процессе 3D Liveness

Получить видео-запись, снятую в процессе 3D Liveness можно только в том случае, если в вашем договоре на оказание услуг указана данная возможность и в параметре scope было передано значение liveness\_3d или liveness\_3d\_verification. Для уточнения возможности получения данной видео-записи обратитесь к вашему проектному менеджеру.&#x20;

**/api/v1/liveness-3d/video** - метод получения видеозаписи снятой в процессе 3D liveness, описание метода см., [здесь](https://docs.passport.aitu.io/#tag/Rabota-s-dannymi-polzovatelya)

#### Получение фото документа из ГБД ФЛ

Получить фотографию документа, удостоверяющего личность пользователя можно только в том случае, если в ссылке-запросе авторизации, в параметре scope было передано значение **id\_card\_photo**&#x20;

**/api/v1/documents/photos** - метод получения фото документа, удостоверяющего личность, описание метода см., [здесь](https://docs.passport.aitu.io/#tag/Rabota-s-dannymi-polzovatelya)

#### Получение фотографии с изображением лица Пользователя (selfie)

Получить фотографию c изображением лица пользователя можно только в том случае, если в ссылке-запросе авторизации, в параметре scope было передано значение **selfie**.

**/api/v1/profile/selfie** - метод получения фото c изображением лица пользователя, описание метода см., [здесь](https://docs.passport.aitu.io/#tag/Rabota-s-dannymi-polzovatelya)

## Связанные статьи

* [Термины и определения](/aituapps/aitu-passport/osnovnye-terminy-i-opredeleniya.md)
* [Окружение системы Aitu Passport](/aituapps/aitu-passport/integraciya-s-aitu-passport/resursy-dlya-integracii.md)
* [Регистрация Партнера](/aituapps/aitu-passport/integraciya-s-aitu-passport/registraciya-v-klientskoi-konsoli.md)
* [Создание сервиса Партнера](/aituapps/aitu-passport/integraciya-s-aitu-passport/sozdanie-servisa.md)
* [Список сервисов Aitu Passport](/aituapps/aitu-passport/integraciya-s-aitu-passport/spisok-servisov-aitu-passport-scope.md)
* [Авторизация](/aituapps/aitu-passport/integraciya-s-aitu-passport/avtorizaciya.md#avtorizaciya-v-aitu-passport)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aitu.io/aituapps/aitu-passport/integraciya-s-aitu-passport/poluchenie-dannykh-polzovatelya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.