Getting Started

Introduction

Copy page

This API is intended to enable third parties to leverage the signing service that Sajnat provides.

Limitations

Each API user is limited to 600 requests per minute. You can inspect the quouta by checking the x-ratelimit-limit and x-ratelimit-remaining respectively

Configuration

If you need access to the test platform, send us an email to info@sajnat.se.

Usage

The basic flow of the API is as follows:

1. Create a new document
2. Create subjects (signees)
3. Send signature requests to the subjects
4. Listen to webhooks on the progress of the signing process
5. Collect the signed pdf from a secure link sent via the webhook service

Checking the sealed document integrity

When a document is sealed the system will certify the document which will in turn detect any changes made to the file. The attached file can be inspected and extracted using PDF viewing software such as Adobe Acrobat or Foxit Reader. Please note the certification text "Certified by Sajnat" displayed in the screenshot below.

You can open the signature panel to view the certification details:

When a document is sealed the system will create an XAdES file and attach that file in the resulting PDF.

The file inlcludes two attachments.

• A zip file which includes the document the subject (signer) actually saw when signing the document.
• An XML-file in XAdES format which includes all event data. This file is protected from editing. Any editing will invalidate the embedded signature.

Excerpt from the XML-file:

Code
 
<?xml version="1.0"?>
<root>
  <data>
    <events>
      <agreementUuid>faa8747e-5364-4cde-97da-4c3855ead473</agreementUuid>
      <activityDescription>created</activityDescription>
      <completedAt>2022-06-22T07:12:18.000000Z</completedAt>
      <createdAt>2022-06-22T07:12:18.000000Z</createdAt>
      <signatureRequestUuid></signatureRequestUuid>
      <activityDescriptionText></activityDescriptionText>
      <subjectFirstName></subjectFirstName>
      <subjectLastName></subjectLastName>
      <subjectEmail></subjectEmail>
      <ipAddress></ipAddress>
      <userAgent></userAgent>
      <signatureIpAddress></signatureIpAddress>
      <signatureUserAgent></signatureUserAgent>
    </events>
    <events>
      <agreementUuid>faa8747e-5364-4cde-97da-4c3855ead473</agreementUuid>
      <activityDescription>signature_request_sent</activityDescription>
      <completedAt>2022-06-22T07:12:41.000000Z</completedAt>
      <createdAt>2022-06-22T07:12:41.000000Z</createdAt>
      <signatureRequestUuid>b4a7bd1e-c231-465c-9e16-c0d5b922fd67</signatureRequestUuid>
      <activityDescriptionText>Sent</activityDescriptionText>
      <subjectFirstName>Albin</subjectFirstName>
      <subjectLastName>Nilsson</subjectLastName>
      <subjectEmail>albin@sajnat.se</subjectEmail>
      <ipAddress></ipAddress>
      <userAgent></userAgent>
      <signatureIpAddress>80.68.103.135</signatureIpAddress>
      <signatureUserAgent>Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.0.0 Safari/537.36</signatureUserAgent>
    </events>
<!-- etc --->