...
Every call to the Web API interfaces require HTTP Authorization header with a Bearer authentication scheme: Authorization: Bearer BgV57K7vCwGE2vXex7BcgahRMeYoBQgdSJWhcQoJXhF4. Authorization tokens for this header can be obtained by an administrator from Web API Keys tab in the Contract Signatures Apps page. Every key is associated with the following security attributes which define its:
Privileges - to which interfaces the key may be used
Not valid before - from when the key may be used
Not valid after - till when the key may be used
Allowed IPs - from what IPs (ranges) the key may be used
When any of the above criteria is not meet met 401 Unauthorized or 403 Forbidden HTTP status codes are returned.
...
| Note |
|---|
Key secret tokens should be placed in files on destination instances only with a maximally restricted file access attributes and loaded into the application on a start. Even better would be to use some secret management utility sometimes provided by cloud operators. |
...
GET https://contract-signatures.com/webapi/contracts/{contract-id}
Returns Contract Object with signers' personal data or 404 Not Found HTTP status.
...
field name | format / | description / |
|---|---|---|
totalCount | non negative integer | Number of all contracts matching the search parameters. |
always | 0 | |
contracts | array of Contract Objects | Not present when selected page has no contracts. Does not contain signers' data. |
optional |
...
field name | format / | description / |
|---|---|---|
templateId | printable US-ASCII string | Confluence page or Jira issue identifier from which a contract will be created. |
required | "1234567" | |
name | printable Unicode string | Name of a contract. |
required | "NDA" | |
sequentialSigning | boolean | Will the invitation email be sent after a previous signer decision ? Defaults to false. |
optional | true | |
signers | array of Signer Creation Objects | At least one signer is required. No more then 26 signers are allowed. |
required |
...
field name | format / | description / |
|---|---|---|
id | UUID | This contract identifier. |
always | 15f5b906-1076-4539-a9ac-0be80bdef973 | |
templateId | printable US-ASCII string | Confluence page or Jira issue identifier. |
always | "654321" | |
collectionId | printable US-ASCII string | Confluence space or Jira project identifier. |
always | "123456" | |
name | printable Unicode string | This contract name. |
always | "NDA" | |
createdById | printable US-ASCII string | Atlassian user identifier of this contract creator. |
always | "123456:b84aeffd-32e5-4b4b-a012-89bf06cae06e" | |
creationTimestamp | ISO 8601 | Time at which this contract creation has been requested. |
always | "2022-09-16T13:28:37.4951Z" | |
expirationTimestamp | ISO 8601 | Time at which this contract become expired. |
always | "2022-09-23T13:28:37.4951Z" | |
sequentialSigning | boolean | Is an invitation email sent after a previous signer decision ? |
always | false | |
archivalTimestamp | ISO 8601 | Time at which this contract has been move to the archive. |
conditional | "2022-09-30T13:28:37.932523Z" | |
status | "sent" or | This contract status:
|
always | "signed" | |
signers | array of Signer Objects | Present only in the |
conditional | ||
finalizedPdf | Present if there is an attachment in the Confluence/Jira containing PDF with the final version of the contract. | |
conditional | ||
certificatePdf | Present if there is an attachment in the Confluence/Jira containing PDF certificate for the final version of the contract. | |
conditional |
...