SignAPI interfaces

Session API

Description
Session API main scope is to manage file processing sessions.

Session API contains two methods:

  • Create session
  • Close session
Session API URL
/api-session/v1.0/

Operations

MethodEndpointDescription
GETstartData processing session creation
GET{sessionId}/closeClosing data processing session

Storage API

Description
Storage API main scope is to manage files or digests within the session.

Storage API contains following methods:

  • Upload file
  • Add document digest
  • List files
  • Download file
  • Delete file
Storage API URL
/api-storage/v1.0/

Operations

MethodEndpointDescription
PUT{sessionId}/uploadUpload file
GET{sessionId}/listRetrieve file list in specific session
GET{sessionId}/{documentiId}Download file
DELETE{sessionId}/{documentiId}Delete file
POST{sessionId}/addDocumentDigestAdd file digest and file name for signing

Signing API

Description
Signing API main scope is to manage signatures/seals of archive timestamps within the session.

Signing API contains following methods:

  • Calculate digest
  • Finalize signing
  • Add archive timestamp
  • Create electronic seal
Signing API URI
/api-sign/v1.0/

Operations

MethodEndpointDescription
POSTcalculateDigestSignable data calculation
POSTfinalizeSigningSigned document finalization
POSTaddArchiveArchive timestamp request
POSTeSealCreateCreates electronic seal with client provided electronic seal key

Validation API

Description
Validation API main scope is to validate electronic signatures/seals of archive timestamps.

Validation API URI
/api-validation/v1.0/

Operations

MethodEndpointDescription
GET{sessionId}/{documentiId}/validateValidation of signed file

Share API

Description
Share API main scope is to manage session sharing.

Share API contains following methods:

  • Start sharing
  • Persons in session
  • Sessions of a Person
  • Remove sharing
Share API URI
/api-share/v1.0/

Operations

MethodEndpointDescription
POST{sessionId}/personsAdd access rights to a specific session
GET{sessionId}/personsFind out the persons with whom session is shared
GET{personId}/sessionsFind out the sessions which are shared with the specific person
DELETE{sessionId}/persons/{personId}Remove access rights from the specific session

Configuration API

Description
Configuration API main scope is to provide registered information to Service provider.

Configuration API URI
/api-config/v1.0/

Operations

MethodEndpointDescription
GETRetrieve Service provider's configuration