# Подписания

> REST API раздела «Подписания»: 53 операции.

Базовый адрес: `https://api.legalstack.ru`. Спецификация: [openapi/signatures.json](https://docs.legalstack.ru/openapi/signatures.json).

- [Запросы на подпись](https://docs.legalstack.ru/api/signatures/signature): Электронные подписи: запросы, проверка, отзыв.
- [Факсимиле и печати](https://docs.legalstack.ru/api/signatures/signature-assets): Файлы и снимки подписи.
- [Подписание по ссылке](https://docs.legalstack.ru/api/signatures/signature-sign-public): Публичное подписание по короткой ссылке (OTP).
- [Проверка подписи](https://docs.legalstack.ru/api/signatures/signature-verify): Публичная верификация подписей.

## Операции

Всего операций: 53. У каждой операции своя страница со схемами запроса и ответа и примерами вызова.

### [Запросы на подпись](https://docs.legalstack.ru/api/signatures/signature)

| Метод | Путь | Операция |
| --- | --- | --- |
| `POST` | `/api/v1/signatures` | [Создать запрос на подпись](https://docs.legalstack.ru/api/signatures/signature/post-signatures) |
| `GET` | `/api/v1/signatures/inbox` | [Входящие запросы на подпись](https://docs.legalstack.ru/api/signatures/signature/get-signatures-inbox) |
| `POST` | `/api/v1/signatures/parties` | [Стороны документов для подписантов](https://docs.legalstack.ru/api/signatures/signature/post-signatures-parties) |
| `GET` | `/api/v1/signatures/sent` | [Отправленные запросы на подпись](https://docs.legalstack.ru/api/signatures/signature/get-signatures-sent) |
| `DELETE` | `/api/v1/signatures/{id}` | [Удалить запрос на подпись](https://docs.legalstack.ru/api/signatures/signature/delete-signatures-id) |
| `GET` | `/api/v1/signatures/{id}` | [Получить запрос на подпись](https://docs.legalstack.ru/api/signatures/signature/get-signatures-id) |
| `PATCH` | `/api/v1/signatures/{id}` | [Переименовать запрос на подпись](https://docs.legalstack.ru/api/signatures/signature/patch-signatures-id) |
| `POST` | `/api/v1/signatures/{id}/certificate-check` | [Проверить сертификат УКЭП до подписания](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-certificate-check) |
| `GET` | `/api/v1/signatures/{id}/comments` | [Список комментариев к подписанию](https://docs.legalstack.ru/api/signatures/signature/get-signatures-id-comments) |
| `POST` | `/api/v1/signatures/{id}/comments` | [Добавить комментарий к подписанию](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-comments) |
| `POST` | `/api/v1/signatures/{id}/comments/read` | [Отметить переписку по подписанию прочитанной](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-comments-read) |
| `GET` | `/api/v1/signatures/{id}/document` | [Получить документ для предпросмотра (актуальный или подписанный снимок)](https://docs.legalstack.ru/api/signatures/signature/get-signatures-id-document) |
| `GET` | `/api/v1/signatures/{id}/document.pdf` | [Замороженный PDF документа, который подписывается](https://docs.legalstack.ru/api/signatures/signature/get-signatures-id-document-pdf) |
| `POST` | `/api/v1/signatures/{id}/duplicate` | [Дублировать запрос на подпись](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-duplicate) |
| `GET` | `/api/v1/signatures/{id}/export/package` | [Архивный пакет: подписанные PDF, файлы подписей, протокол и манифест](https://docs.legalstack.ru/api/signatures/signature/get-signatures-id-export-package) |
| `GET` | `/api/v1/signatures/{id}/export/pdf` | [Экспорт PDF по запросу на подпись (снимок и подписи этого запроса)](https://docs.legalstack.ru/api/signatures/signature/get-signatures-id-export-pdf) |
| `POST` | `/api/v1/signatures/{id}/power-of-attorney-check` | [Проверить машиночитаемую доверенность до подписания](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-power-of-attorney-check) |
| `POST` | `/api/v1/signatures/{id}/reject` | [Отклонить подпись](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-reject) |
| `POST` | `/api/v1/signatures/{id}/remind` | [Отправить напоминание подписанту](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-remind) |
| `POST` | `/api/v1/signatures/{id}/revoke` | [Отозвать подпись](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-revoke) |
| `POST` | `/api/v1/signatures/{id}/send-otp` | [Отправить подписанту одноразовый код (OTP)](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-send-otp) |
| `POST` | `/api/v1/signatures/{id}/sign` | [Подписать документ](https://docs.legalstack.ru/api/signatures/signature/post-signatures-id-sign) |
| `GET` | `/api/v1/signatures/{id}/snapshot-to-sign` | [Получить замороженные PDF документов для подписи](https://docs.legalstack.ru/api/signatures/signature/get-signatures-id-snapshot-to-sign) |

### [Факсимиле и печати](https://docs.legalstack.ru/api/signatures/signature-assets)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/signatures/assets` | [Список факсимиле и печатей команды](https://docs.legalstack.ru/api/signatures/signature-assets/get-signatures-assets) |
| `POST` | `/api/v1/signatures/assets` | [Загрузить факсимиле или печать](https://docs.legalstack.ru/api/signatures/signature-assets/post-signatures-assets) |
| `POST` | `/api/v1/signatures/assets/team` | [Загрузить ассет команды (логотип, печать)](https://docs.legalstack.ru/api/signatures/signature-assets/post-signatures-assets-team) |
| `GET` | `/api/v1/signatures/assets/user/{userId}` | [Список факсимиле и печатей пользователя](https://docs.legalstack.ru/api/signatures/signature-assets/get-signatures-assets-user-userid) |
| `DELETE` | `/api/v1/signatures/assets/{id}` | [Удалить факсимиле/печать](https://docs.legalstack.ru/api/signatures/signature-assets/delete-signatures-assets-id) |
| `GET` | `/api/v1/signatures/assets/{id}/file` | [Получить изображение факсимиле/печати](https://docs.legalstack.ru/api/signatures/signature-assets/get-signatures-assets-id-file) |

### [Подписание по ссылке](https://docs.legalstack.ru/api/signatures/signature-sign-public)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/signatures/sign-public/{shortId}` | [Контекст подписания для публичного подписанта](https://docs.legalstack.ru/api/signatures/signature-sign-public/get-signatures-sign-public-shortid) |
| `GET` | `/api/v1/signatures/sign-public/{shortId}/assets/{kind}` | [Изображение подписи или печати, доступное публичному подписанту](https://docs.legalstack.ru/api/signatures/signature-sign-public/get-signatures-sign-public-shortid-assets-kind) |
| `POST` | `/api/v1/signatures/sign-public/{shortId}/certificate-check` | [Проверить сертификат УКЭП до подписания](https://docs.legalstack.ru/api/signatures/signature-sign-public/post-signatures-sign-public-shortid-certificate-check) |
| `GET` | `/api/v1/signatures/sign-public/{shortId}/comments` | [Переписка подписанта с инициатором (публично, по короткому идентификатору)](https://docs.legalstack.ru/api/signatures/signature-sign-public/get-signatures-sign-public-shortid-comments) |
| `POST` | `/api/v1/signatures/sign-public/{shortId}/comments` | [Добавить комментарий (публично, как подписант)](https://docs.legalstack.ru/api/signatures/signature-sign-public/post-signatures-sign-public-shortid-comments) |
| `POST` | `/api/v1/signatures/sign-public/{shortId}/comments/read` | [Отметить переписку прочитанной (публично, как подписант)](https://docs.legalstack.ru/api/signatures/signature-sign-public/post-signatures-sign-public-shortid-comments-read) |
| `GET` | `/api/v1/signatures/sign-public/{shortId}/document.pdf` | [PDF документа для предпросмотра подписанту](https://docs.legalstack.ru/api/signatures/signature-sign-public/get-signatures-sign-public-shortid-document-pdf) |
| `POST` | `/api/v1/signatures/sign-public/{shortId}/power-of-attorney-check` | [Проверить машиночитаемую доверенность до подписания](https://docs.legalstack.ru/api/signatures/signature-sign-public/post-signatures-sign-public-shortid-power-of-attorney-check) |
| `POST` | `/api/v1/signatures/sign-public/{shortId}/reject` | [Отклонить подписание](https://docs.legalstack.ru/api/signatures/signature-sign-public/post-signatures-sign-public-shortid-reject) |
| `POST` | `/api/v1/signatures/sign-public/{shortId}/send-otp` | [Отправить OTP подписанту](https://docs.legalstack.ru/api/signatures/signature-sign-public/post-signatures-sign-public-shortid-send-otp) |
| `POST` | `/api/v1/signatures/sign-public/{shortId}/sign` | [Подписать документ](https://docs.legalstack.ru/api/signatures/signature-sign-public/post-signatures-sign-public-shortid-sign) |
| `GET` | `/api/v1/signatures/sign-public/{shortId}/snapshot-to-sign` | [Замороженные PDF документов для подписи УКЭП](https://docs.legalstack.ru/api/signatures/signature-sign-public/get-signatures-sign-public-shortid-snapshot-to-sign) |

### [Проверка подписи](https://docs.legalstack.ru/api/signatures/signature-verify)

| Метод | Путь | Операция |
| --- | --- | --- |
| `GET` | `/api/v1/verify/blob/{blob}` | [Получить короткий идентификатор из ссылки проверки](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-blob-blob) |
| `GET` | `/api/v1/verify/{shortId}` | [Проверить подпись по короткому идентификатору](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-shortid) |
| `GET` | `/api/v1/verify/{shortId}/document` | [Получить снимок подписанного документа для отображения](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-shortid-document) |
| `GET` | `/api/v1/verify/{shortId}/document.docx` | [Экспортировать подписанный документ в DOCX](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-shortid-document-docx) |
| `GET` | `/api/v1/verify/{shortId}/document.pdf` | [Экспортировать подписанный документ в PDF](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-shortid-document-pdf) |
| `GET` | `/api/v1/verify/{shortId}/documents/{documentId}/original.pdf` | [PDF документа ровно в том виде, в котором его подписали](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-shortid-documents-documentid-original-pdf) |
| `GET` | `/api/v1/verify/{shortId}/documents/{documentId}/signature.sig` | [Отсоединённая подпись CAdES к подписанному PDF](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-shortid-documents-documentid-signature-sig) |
| `GET` | `/api/v1/verify/{shortId}/package.zip` | [Архивный пакет: подписанные PDF, файлы подписей, протокол и манифест](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-shortid-package-zip) |
| `GET` | `/api/v1/verify/{shortId}/power-of-attorney.xml` | [Машиночитаемая доверенность, по которой действовал подписант](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-shortid-power-of-attorney-xml) |
| `GET` | `/api/v1/verify/{shortId}/power-of-attorney.xml.sig` | [Подпись доверителя к машиночитаемой доверенности](https://docs.legalstack.ru/api/signatures/signature-verify/get-verify-shortid-power-of-attorney-xml-sig) |
| `POST` | `/api/v1/verify/{shortId}/send-pdf` | [Отправить PDF подписанного документа на разрешённый адрес](https://docs.legalstack.ru/api/signatures/signature-verify/post-verify-shortid-send-pdf) |
| `POST` | `/api/v1/verify/{shortId}/unlock` | [Разблокировать доступ к проверке кодом](https://docs.legalstack.ru/api/signatures/signature-verify/post-verify-shortid-unlock) |