# Підписати файл ключем співробітника компанії POST /api/external/company/sign/file

##### **REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 98.0952%;"><tbody><tr class="row-odd"><td style="width: 21.6285%;">**URL**

</td><td style="width: 78.3397%;"> </td></tr><tr class="row-even"><td style="width: 21.6285%;">Метод запиту

</td><td style="width: 78.3397%;">POST

</td></tr><tr class="row-odd"><td style="width: 21.6285%;">URL запиту

</td><td style="width: 78.3397%;">**/api/external/company/sign/file**

</td></tr><tr><td style="width: 21.6285%;">**Authorization**

</td><td style="width: 78.3397%;">  
</td></tr><tr><td style="width: 21.6285%;">Auth type

</td><td style="width: 78.3397%;">API key</td></tr><tr><td style="width: 21.6285%;">Key / Value

</td><td style="width: 78.3397%;">**x-system-id** / токен, отриманий при підключенні</td></tr><tr class="row-odd"><td style="width: 21.6285%;">**Headers**

</td><td style="width: 78.3397%;"> </td></tr><tr class="row-odd"><td style="width: 21.6285%;">Content-Type

</td><td style="width: 78.3397%;">[multipart/form-data](https://tools.ietf.org/html/rfc7578)

</td></tr><tr><td style="width: 21.6285%;">**Request body**

</td><td style="width: 78.3397%;">Параметри тіла запиту:

- **password** – [зашифрований пароль.](https://wiki-v2.edin.ua/books/robota-z-api-portalu-edin-id/page/sifruvannia-parolia-za-dopomogoiu-vidkritogo-kliuca-rsa "Шифрування пароля за допомогою відкритого ключа RSA")
- **file.pdf** – дані (контент) для підпису у вигляді файлу або base64 (залежно від **inputFormat**)

</td></tr><tr><td style="width: 21.6285%;">**Params**

</td><td style="width: 78.3397%;">- **key** – ідентифікатор ключа.
- **type –** тип підписання, може приймати значення: 
    - append – додає підпис до переданого файлу. **ВАЖЛИВО!** Якщо файл вже був підписаний, то підпис додається до існуючого, а не підписується разом з існуючим підписом.
    - sign - підписує контент, використовується за замовчуванням.
- **result –** формат підписання (дані й підпис в одному файлі, дані й підпис в окремих файлах), може приймати значення: 
    - enveloped – у відповідь надійде файл з підписом
    - detached – у відповідь надійде тільки підпис
- **inputFormat** – формат вхідних даних для підписання, може приймати значення: 
    - file – файл в бінарному вигляді
    - base64 – файл у вигляді base64 рядка
- **outputFormat** – формат вихідних (результуючих) даних після підписання, може приймати значення: 
    - file – файл в бінарному вигляді
    - base64 – файл у вигляді base64 рядка
- **signType** – тип підпису, приймає значення CADES\_BES<span class="token punctuation">,</span> CADES\_T<span class="token punctuation">,</span> CADES\_C<span class="token punctuation">,</span> CADES\_X\_LONG<span class="token punctuation">,</span> CADES\_X\_LONG\_TRUSTED. Якщо не передано, то за замовченням підставляється CADES\_BES
- **algorithm** (enum) - алгоритм формату підписання: 
    - DSTU4145\_GOST34311<span class="token punctuation">,</span>
    - DSTU4145\_DSTU7564<span class="token punctuation">,</span>
    - ECDSA

</td></tr></tbody></table>

</div>##### **RESPONSE**

В тілі **відповіді** повертаються код 200 та результат підписання відповідно до параметрів **result** та **outputFormat.**