{"openapi":"3.1.0","info":{"title":"Signatus API","description":"Signatus integration API","contact":{"name":"Support","email":"signatus.support@anasoft.com"},"version":"1.0"},"servers":[{"url":"http://api.okdokument.com","description":"Generated server url"}],"paths":{"/rest/state":{"post":{"tags":["sts-controller"],"summary":"Acknowledge download - Change document state","description":"Updates the state of a document (e.g., download, open, cancel). Consumes form data. This service is optional. When using `cookieAuth`, the `JSESSIONID` cookie from the `/api/login` response should be used.","operationId":"changeState","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/a"}}},"required":true},"responses":{"200":{"description":"State change successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"},"examples":{"Response Example":{"description":"Response Example","value":{"message":"msg.document.move.success","result":"rorBJvTZ_-qsm8101I4DfaD7PJQDbl0sUnmAF4r8Vmm4vFDJV8rRvSGoYf3e24UZVzkq6_5fYkX6d1Sgtm1eYd7tq9pXjp3tJluzKgJBIzg"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"404":{"description":"Document not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}},"security":[{"basicAuth":[]},{"cookieAuth":[]}]}},"/rest/document":{"post":{"tags":["sts-controller"],"summary":"Upload a new or update existing document","description":"Uploads a document with metadata. The endpoint consumes data in multipart/form-data format. When using `cookieAuth`, the `JSESSIONID` cookie from the `/api/login` response should be used.","operationId":"uploadFile","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/g"}}},"required":true},"responses":{"200":{"description":"Document upload successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"},"examples":{"Response Example":{"description":"Response Example","value":{"message":"msg.document.upload","result":"rorBJvTZ_-qsm8101I4DfaD7PJQDbl0sUnmAF4r8Vmm4vFDJV8rRvSGoYf3e24UZVzkq6_5fYkX6d1Sgtm1eYd7tq9pXjp3tJluzKgJBIzg"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"404":{"description":"Document not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}},"security":[{"basicAuth":[]},{"cookieAuth":[]}]}},"/fe/user":{"post":{"tags":["fe-sts-controller"],"operationId":"createUser","requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}},"patch":{"tags":["fe-sts-controller"],"operationId":"updateUser","requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}},"/JSON/user":{"post":{"tags":["json-sts-controller"],"operationId":"createUser_1","requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}},"patch":{"tags":["json-sts-controller"],"operationId":"updateUser_1","requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}},"/JSON/upload":{"post":{"tags":["json-sts-controller"],"operationId":"upload","parameters":[{"name":"fileMap","in":"query","required":true,"schema":{"type":"object","additionalProperties":{"type":"string","format":"binary"}}},{"name":"dataText","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}},"patch":{"tags":["json-sts-controller"],"operationId":"update","parameters":[{"name":"fileMap","in":"query","required":true,"schema":{"type":"object","additionalProperties":{"type":"string","format":"binary"}}},{"name":"dataText","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}},"/JSON/signatureRequest":{"post":{"tags":["json-sts-controller"],"operationId":"createSignatureRequest","requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}},"patch":{"tags":["json-sts-controller"],"operationId":"updatSignatureRequest","requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}},"/JSON/signatureRequest/{id}":{"post":{"tags":["json-sts-controller"],"operationId":"updateSignatureRequestId","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}},"/JSON/document":{"post":{"tags":["json-sts-controller"],"operationId":"uploadFile_1","requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}},"/JSON/raiseSignatureRequests":{"patch":{"tags":["json-sts-controller"],"operationId":"raiseSignatureRequests","requestBody":{"content":{"application/json":{"schema":{"type":"string"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}},"/rest/list/flat":{"get":{"tags":["sts-controller"],"summary":"List documents","description":"Lists documents for signing. When using `cookieAuth`, the `JSESSIONID` cookie from the `/api/login` response should be used.","operationId":"getFlatList","responses":{"200":{"description":"List of documents","content":{"application/json":{"schema":{"$ref":"#/components/schemas/d"},"examples":{"Response Example":{"description":"Response Example","value":[{"date":1776858989931,"filename":"Test-216.pdf","id":"rorBJvTZ_-qsm8101I4DfaD7PJQDbl0sUnmAF4r8Vmm4vFDJV8rRvSGoYf3e24UZVzkq6_5fYkX6d1Sgtm1eYd7tq9pXjp3tJluzKgJBIzg","modification":"2026-04-22 13:56:29","reuploadState":"signed","state":"tosign","url":"https://ds-sts.ana.sk/rest/document/rorBJvTZ_-qsm8101I4DfaD7PJQDbl0sUnmAF4r8Vmm4vFDJV8rRvSGoYf3e24UZVzkq6_5fYkX6d1Sgtm1eYd7tq9pXjp3tJluzKgJBIzg","number":"111","name":"Ernestine Herman","box":"Inbox","group":"tablet","sid":"McKenzie - O'Conner"}]}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}},"security":[{"basicAuth":[]},{"cookieAuth":[]}]}},"/rest/document/{id}":{"get":{"tags":["sts-controller"],"summary":"Download a document","description":"Downloads the document content as binary data for the given document ID. When using `cookieAuth`, the `JSESSIONID` cookie from the `/api/login` response should be used.","operationId":"downloadFile","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Document content","content":{"application/pdf":{}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"404":{"description":"Document not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}},"security":[{"basicAuth":[]},{"cookieAuth":[]}]}},"/fe/usersInfo":{"get":{"tags":["fe-sts-controller"],"operationId":"usersInfo","parameters":[{"name":"filter","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/UserInfo"}}}}}}}},"/fe/roles/list":{"get":{"tags":["fe-sts-controller"],"operationId":"getRoles","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}}}}},"/fe/groups/list":{"get":{"tags":["fe-sts-controller"],"operationId":"getGroups","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}}}}},"/api/login":{"get":{"tags":["sts-controller"],"summary":"Login to server","description":"Authenticates the user and returns user information. This service is optional and primarily used for session-based authentication.","operationId":"loginGet","responses":{"200":{"description":"Successfully authenticated. The session ID is returned in a cookie named `JSESSIONID`. You need to include this cookie in subsequent requests.","headers":{"Set-Cookie":{"description":"JSESSIONID=abcde12345; Path=/; HttpOnly","style":"simple","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/e"},"examples":{"Example Response":{"description":"Example Response","value":{"userInfo":{"roles":["ROLE_USER"],"additional":"test user","userName":"tablet"}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}},"security":[{"basicAuth":[]},{"cookieAuth":[]}]}},"/JSON/logs":{"get":{"tags":["json-sts-controller"],"operationId":"downloadLogs","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string"}},{"name":"data","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string","format":"byte"}}}}}}},"/JSON/list/flat":{"get":{"tags":["json-sts-controller"],"operationId":"getFlatList_1","parameters":[{"name":"query","in":"query","required":true,"schema":{"$ref":"#/components/schemas/Query"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}}}}}},"/JSON/infoApikey/{name}":{"get":{"tags":["json-sts-controller"],"operationId":"infoApikey","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}}}}},"/JSON/document/{id}":{"get":{"tags":["json-sts-controller"],"operationId":"downloadFile_1","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string","format":"byte"}}}}}},"delete":{"tags":["json-sts-controller"],"operationId":"deleteDocument","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultVoid"}}}}}}},"/JSON/document/metadata/{id}":{"get":{"tags":["json-sts-controller"],"operationId":"getMetadata","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Item"}}}}}}},"/JSON/document/base64/{id}":{"get":{"tags":["json-sts-controller"],"operationId":"downloadFileBase64","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}}}}},"/JSON/counter":{"get":{"tags":["json-sts-controller"],"operationId":"counter","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"string"}}}}}}},"/fe/user/{name}":{"delete":{"tags":["fe-sts-controller"],"operationId":"deleteUser","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}},"/JSON/user/{name}":{"delete":{"tags":["json-sts-controller"],"operationId":"deleteUser_1","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}},"/JSON/signatureRequest/{signatureRequestId}":{"delete":{"tags":["json-sts-controller"],"operationId":"deleteSignatureRequest","parameters":[{"name":"signatureRequestId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultString"}}}}}}}},"components":{"schemas":{"a":{},"Result":{"type":"object","properties":{"message":{"type":"string"},"result":{},"url":{"type":"string"},"documentId":{"type":"string"}}},"ErrorBody":{"type":"object","properties":{"message":{"type":"string"},"value":{},"tenant":{"type":"string"}}},"g":{},"JSONObject":{"type":"object","properties":{"empty":{"type":"boolean"}}},"ResultString":{"type":"object","properties":{"message":{"type":"string"},"result":{"type":"string"},"url":{"type":"string"},"documentId":{"type":"string"}}},"d":{},"Metadata":{"type":"object","properties":{"metadataFromArray":{"type":"array","items":{"type":"string"},"writeOnly":true},"groupReduction":{"type":"string"}}},"UserInfo":{"type":"object","properties":{"roles":{"type":"array","items":{"type":"string"}},"groups":{"type":"array","items":{"type":"string"}},"login":{"type":"string","format":"date-time"},"userName":{"type":"string"},"metaData":{"$ref":"#/components/schemas/Metadata"},"viewId":{"type":"string"},"viewData":{"$ref":"#/components/schemas/Metadata"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"additional":{"type":"string"},"partner":{"type":"string"},"company":{"type":"string"},"contact":{"type":"string"},"note":{"type":"string"},"partnerId":{"type":"string"},"clientId":{"type":"string"}}},"e":{},"Query":{"type":"object","properties":{"filename":{"type":"string"},"state":{"type":"string"},"modification":{"type":"string"},"pageNumber":{"type":"integer","format":"int32"},"itemsPerPage":{"type":"integer","format":"int32"},"listStates":{"type":"array","items":{"type":"string"}},"extensionMetadata":{"type":"boolean"},"fileFilter":{},"metadataFromArray":{"type":"array","items":{"type":"string"},"writeOnly":true},"groupReduction":{"type":"string"}}},"Item":{"type":"object","properties":{"filename":{"type":"string"},"state":{"type":"string"},"modification":{"type":"string"},"id":{"type":"string"},"reuploadState":{"type":"string"},"viewId":{"type":"string"},"viewData":{"$ref":"#/components/schemas/JSONObject"},"version":{"type":"integer","format":"int32"},"url":{"type":"string"},"signedCount":{"type":"integer","format":"int32"},"totalCount":{"type":"integer","format":"int32"},"date":{"type":"integer","format":"int64"},"creationTime":{"type":"integer","format":"int64"},"data":{"type":"string","writeOnly":true},"metadataFromArray":{"type":"array","items":{"type":"string"},"writeOnly":true},"groupReduction":{"type":"string"}}},"ResultObject":{"type":"object","properties":{"message":{"type":"string"},"result":{},"url":{"type":"string"},"documentId":{"type":"string"}}},"ResultVoid":{"type":"object","properties":{"message":{"type":"string"},"result":{},"url":{"type":"string"},"documentId":{"type":"string"}}}},"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic"},"cookieAuth":{"type":"apiKey","name":"JSESSIONID","in":"cookie"}}}}