---
title: "Podpíše súbory elektronickou pečaťou"
method: POST
path: "/api/cep/sign_v2"
tags: ["Podpisovanie"]
---

# Podpíše súbory elektronickou pečaťou

`POST /api/cep/sign_v2`

## Request

- Base URL: `https://fix.slovensko-sk-api.staging.slovensko.digital`
- URL: `https://fix.slovensko-sk-api.staging.slovensko.digital/api/cep/sign_v2`
- Auth: HTTP bearer

Podpíše súbory elektronickou pečaťou a overí vstupné dokumenty vočí validátorom dátových objektov.
Spracúva viacero skupín objektov v jednom requeste. Umožňuje aj spoločne podpisovať viacero nepodpísaných objektov jedným podpisom, pridávať podpis do podpisovej obálky a spoločne podpisovať nepodpísané objekty s už podpísanými objektami z ASiC-E XAdES alebo ASiC-E CAdES jedným podpisom.

## Request body

- object
  - `object_groups` CepSigningV2ObjectGroup[], required: Skupiny objektov, ktoré sa majú podpisovať spolu.
    - `signing_certificate` CepSigningCertificate, required: Štruktúra pre výber podpisového certifkátu.
      - `type` 'Issuer' | 'Subject' | 'URI', required: Typ výberu podpisového certifikátu: - `Issuer` znamená výber certifikátu podľa vydavateľa a sériového čísla, ktoré sú uvedené v atribúte `issuer`, - `Subject` znamená výber certifikátu podľa subjektu v certifikáte, ktorý je uvedený v atribúte `subject`, - `URI` znamená výber certifikátu podľa URI evidovaného na strane ÚPVS, ktorý je uvedený v atribúte `uri`.
      - `issuer` string, base64: Vydavateľ podpisového certifikátu, iba pre typ `Issuer`.
      - `issuer_serial_number` string, base64: Sériové číslo podpisového certifikátu, iba pre typ `Issuer`.
      - `subject` string: Subjekt podpisového certifikátu, iba pre typ `Subject`.
      - `uri` string, uri: URI podpisového certifikátu, iba pre typ `URI`.
    - `unsigned_objects` CepSigningObjectV2[]
      - `id` string, uri, required: Identifikátor objektu v tvare URI. Hodnota z evidencie dátových objektov.
      - `data` string, base64, required: Obsah objektu zakódovaný podľa hodnoty v base64.
      - `name` string, nullable: Názov objektu.
      - `visualization_uri` string, uri: Identifikátor podpisovej vizualizácie.
    - `signed_object` string, base64: Už podpísaný ASiC kontajner určený na podpis - obsah ASiC kontajnera zakódovaný v base64
    - `id` string, uuid, required: Identifikátor množiny objektov.
  - `pdf_verification` boolean: Indikátor overenia obsahu objektu podľa štandardu PDF/A-1a.

## Response `200`

Úspešne podpísané súbory elektronickou pečaťou.

- object
  - `sign_result` integer, required: Kód výsledku podpísania.
  - `sign_description` string, required: Popis výsledku podpísania.
  - `signed_object_groups` CepSignedObjectGroup[]: Podpísané objekty.
    - `id` string, uuid: Identifikátor podpisového konatjnera.
    - `mime_type` string: MimeType podpisového kontajnera.
    - `data` string, base64: Obsah ASiC kontajnera zakódovaný v base64.
    - `timestamp_certificate` string, base64: Certifikát poslednej časovej pečiatky v base64.

## Changes

- **2023-09-14** `4960d3481742`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/slovensko-digital/apis/slovensko-sk-api/changes/api/cep/sign_v2/post.md)

---

[API](https://skmtc.dev/slovensko-digital/apis/slovensko-sk-api.md) - [All operations](https://skmtc.dev/slovensko-digital/apis/slovensko-sk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/slovensko-digital/apis/slovensko-sk-api/revisions/e8ab6a2875b7?raw)
