# API сертификаты КЭП

Электронная подпись — цифровой аналог собственноручной подписи, предназначенный для защиты документа от внесения несанкционированных изменений и для подтверждения авторства. 

Электронный документ, подписанный ЭП, имеет такую же юридическую значимость, как и подписанный от руки и скреплённый печатью. Его примут арбитражный суд, ФНС и другие государственные органы.

## Содержание

1. [Подтверждение аккаунта с помощью сертификата КЭП](#post-gw-sign_checker-v4-verify-account-by-signature)
2. [Регистрация сертификата КЭП ИП в системе ЭПД](#post-gw-sign_checker-v4-certificates-{certificate_id}-registration)
3. [Получение данных сертификатов из указанного списка ID (отпечатков) сертификатов ](#get-gw-sign_checker-v4-certificates)
4. [Получение сертификатов авторизованного пользователя](#get-gw-sign_checker-v4-firms-current-user-certificates)


### Подтверждение аккаунта с помощью сертификата КЭП

Балл за подтверждение аккаунта показывает другим участникам, что вы реальная фирма или реальный человек, и открывает больше возможностей по работе на ATI.SU.
Метод также выполняет проверку подписи.

<a id="post-gw-sign_checker-v4-verify-account-by-signature"></a>

Подтверждение аккаунта с помощью сертификата КЭП

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/sign_checker/v4/verify-account-by-signature?verify_signature=true' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: multipart/form-data; boundary=boundary'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/doki/certificates.openapi.json)

**Пример ответа (422)**

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Регистрация сертификата КЭП ИП в системе ЭПД

Запускает подключение ИП к системе оператора ЭПД с указанием адреса регистрации.

Примечание: подключение ЮЛ к системе ЭПД происходит в фоновом режиме при проверке подписи.

<a id="post-gw-sign_checker-v4-certificates-{certificate_id}-registration"></a>

Регистрация сертификата ИП в системе ЭПД

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/sign_checker/v4/certificates/[a-fA-F0-9]{40}/registration' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "postcode": "^\\d{6}$",
  "region_id": 0,
  "district": "^[^,]*$",
  "city": "^[^,]*$",
  "locality": "^[^,]*$",
  "street": "string",
  "house": "string",
  "apartment": "string",
  "housing": "string"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/doki/certificates.openapi.json)

**Описание полей запроса**
- `postcode` — Почтовый индекс
- `region_id` — Идентификатор региона
- `district` — Район
- `city` — Город
- `locality` — Населенный пункт
- `street` — Улица
- `house` — Дом
- `apartment` — Квартира
- `housing` — Корпус

**Пример ответа (200)**

```json
{}
```

**Пример ответа (422)**

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Получение данных сертификатов из указанного списка ID (отпечатков) сертификатов 

Возрвщает данные сертификатов из указанного в запросе списка ID (отпечатков).

<a id="get-gw-sign_checker-v4-certificates"></a>

Получение данных сертификатов

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/sign_checker/v4/certificates?certificate_ids=string' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/doki/certificates.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": "string",
    "body": "string",
    "components": {
      "any-key": "string"
    },
    "issuer": {
      "any-key": "string"
    },
    "serial": "string",
    "title": "string",
    "valid_from": "string",
    "valid_until": "string",
    "meta": {
      "revoked": false,
      "created_at": "1970-01-01T00:00:00.000Z"
    }
  }
]
```

**Пример ответа (422)**

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Получение сертификатов авторизованного пользователя

Возвращает все сертификаты (и их данные) авторизованного пользователя, указанного в headers запроса.

<a id="get-gw-sign_checker-v4-firms-current-user-certificates"></a>

Получение сертификатов авторизованного пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/sign_checker/v4/firms/current-user/certificates' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/doki/certificates.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": "string",
    "body": "string",
    "components": {
      "any-key": "string"
    },
    "issuer": {
      "any-key": "string"
    },
    "serial": "string",
    "title": "string",
    "valid_from": "string",
    "valid_until": "string",
    "meta": {
      "revoked": false,
      "created_at": "1970-01-01T00:00:00.000Z"
    }
  }
]
```