.. _Integration_CryptoApi_GettingCertificateMetadata:

Запрос метаданных сертификата
#############################

| Запрос: ``POST certificates/metadata``
| HTTP-заголовки:

.. code-block::

    Authorization: Bearer access_token
    Content-Type: application/json
    Accept: application/json

Тело запроса:

.. code-block:: JSON

    {
        "RawData": "base64",            // данные сертификата или файл ЭП в виде массива байт в Base64
        "Thumbprint": "string",         // отпечаток для поиска сертификата
    }

Описание запроса
****************

Запрос позволяет:

* выполнить разбор метаданных сертификата;
* выполнить поиск сертификата по отпечатку и разобрать его метаданные.

В поле ``RawData`` можно передать как данные сертификата, так и файл электронной подписи.
Если передать файл ЭП, то запрос разберет метаданные сертификата, с помощью которого сформировали ЭП.

Ответ на запрос
***************

В случае успешного выполнения возвращается JSON вида:

.. code-block:: JSON

    {
		"Thumbprint": "string",                                 // отпечаток сертификата
		"ValidFrom": "YYYY-MM-DDThh:mm:ss.fffZ",                // дата и время, с которого действует сертификат
		"ValidTo": "YYYY-MM-DDThh:mm:ss.fffZ",                  // дата и время, по которое действует сертификат
		"RawData": "base64",                                    // данные сертификата в виде массива байт в Base64
		"PublicKeyRawData": "base64"                            // публичный ключ сертификата в виде массива байт в Base64
		"SerialNumber": "string",                               // серийный номер сертификата
		"Surname": "string",                                    // фамилия владельца сертификата
		"FirstName": "string",                                  // имя владельца сертификата            
		"MiddleName": "string",                                 // отчество владельца сертификата
		"CommonName": "string",                                 // общее имя владельца сертификата
		"Position": "string",                                   // должность владельца сертификата
		"OrganizationName": "string",                           // наименование организации, в которой работает владелец сертификата
		"OrganizationInn": "string",                            // ИНН организации, в которой работает владелец сертификата
		"Inn": "string",                                        // ИНН физического лица или ИП, которые владеют сертификатом
		"Snils": "string",                                      // СНИЛС владельца сертификата
		"Email": "string",                                      // e-mail владельца сертификата
		"Department": "string",                                 // подразделение, в котором работает владелец сертификата
		"City": "string",                                       // город (населенный пункт) организации, в которой работает владелец сертификата, или владельца сертификата
		"Street": "string",                                     // улица и номер дома организации, в которой работает владелец сертификата, или владельца сертификата
		"Ogrn": "string",                                       // ОГРН организации, в которой работает владелец сертификата
		"OrgnIp": "string",                                     // ОГРНИП, в которой работает владелец сертификата
		"Region": "string",                                     // регион организации, в которой работает владелец сертификата, или владельца сертификата 
		"Locale": "string",                                     // язык сертификата            
		"RnsFss": "string",                                     // регистрационный номер страхователя ФСС
		"IssuerSimpleName": "string",                           // простое имя издателя сертификата
		"CertificateType": 0                                    // тип сертификата
	}

Поля ``Thumbprint`` и ``SerialNumber`` идентифицируют сертификат.

Поля ``ValidFrom`` и ``ValidTo`` определяют период действия сертификата.

Остальные поля, кроме ``RawData`` - это результат разбора поля ``Subject`` сертификата.

Поле ``RawData`` содержит данные сертификата в виде массива байт в Base64.

Поле ``CertificateType`` содержит одно из возможных значений:

* неизвестный тип (тип ``0``);
* сертификат работника организации (тип ``1``);
* сертификат физ. лица (тип ``2``);
* сертификат ИП (тип ``3``).