Sigmify Stream API Document V0.1
API Connectivity :
Sigmify exposes services via HTTPS on port 443. Clients must support SSLv2 with HIGH strength
cipher suites as defined by the current general release version of the Apache HTTP Server*.
Clients should have an up-to-date CA Certificate registry supporting the “VeriSign Class 3
Secure Server CA – G3” signing certificate.
Acceptable JSON MIME Types for HTTP Content-Type:
- Objects with no properties may be denoted in JSON array syntax.
- Unless otherwise stated, null properties may be indicated with a JSON null or simply omitted.
- JSON Object properties may appear in any order.
- JSON examples in this document are often formatted for visibility, but in practice should contain minimum whitespace.
- Unless otherwise stated, all properties and values are case sensitive.
- If the HTTP request headers indicate compliance, the response body may optionally be gzip or deflate encoded.
- The encoding will be indicated in the “ContentEncoding” response header. All requests should be encoded in Unicode UTF-8. Responses will be presented in Unicode UTF-8.
Authentication for Webservices :
Authentication token is expected with each API request. Client needs to call getAuthToken service to get a valid token which can then be used in subsequent requests. Token will expire after 30 minutes.
Every subsequent request needs to pass the token with attribute name “authToken”.
Login request requires user and password parameters passed using HTTP POST method.
“message”: “Password is incorrect”,
Client should make no more than 3 attempts to retry a failed authentication.
Webservices for updating Sigmify Stream
After getting the token using the getAuthToken service, the sigmify stream can be updated using updateSigmifyStream API call.
This is a post service.The token generated is sent as a parameter to this post and the data to be updated is sent as a plain JSON string.
“processName”: “Leave Process”,
“messageDate”: “2015-03-14 15:20:36+05:30”,
“documentName”: “Approve Leaave”,
“docCodePrev”: ” DC00AT001″,
“docNoPrev”: ” DN00001001″,
“subject1”: “employee name”,
“subject2”: “2015-03-01 “,
“subject3”: “Going out of station”,
“subject4”: “10 Days”,
“subject5”: “Approved by Supervisor”,
” assignedToRoles”: “RoleCode1,RoleCode2″,
” assignedToUsers”: “user_code1, user_code2,user_code3”,
“completedDate”: “2015-03-16 15:20:36”
“remarks”: “successfully updated”
“remarks”: “unable to update record”
Explanation of the JSON properties :
|Origin||Will always be ‘External’ when called from a third party. The Unique ID allocated for your organization.||Yes|
|tenantId||The unique ID allocated by Sigmify to your organisation. This is allocated at the time of registration.||Yes|
|processName||Name of the process of which the data is being fed into the Sigmify stream.||Yes|
|processCode||Code of the process||No|
|tranxNo||A unique identifier for the transaction of the said process.||Yes|
|messageId||An Id to uniquely identity the current message.||Yes|
|messageStatus||Status of the message – P:Pending / D:Completed||Yes|
|messageDate||Date of the message||Yes|
|documentName||Name of the document whose data is being fed.||Yes|
|docCode||ID(if any) of the document whose data is being fed.||No|
|docCodePrev||ID(if any) of the document preceding the current document.||No|
|docNo||Unique number allocated to the instance of the document (if any).||No|
|docNoPrev||Unique number allocated to the instance of the previous document (if any).||No|
|subject1||Data field that needs to be displayed in the Sigmify stream on the placeholder1||Yes|
|subject2||Data field that needs to be displayed in the Sigmify stream on the placeholder2||Yes|
|Subject3||Data field that needs to be displayed in the Sigmify stream on the placeholder3||No|
|Subject4||Data field that needs to be displayed in the Sigmify stream on the placeholder4||No|
|Subject5||Data field that needs to be displayed in the Sigmify stream on the placeholder5||No|
|Link||URL to open the document from the sigmify stream. If case of a document that is to be opened in read only|
mode, please construct the URL accordingly and pass. If the URL is not passed, the link will not be enabled on the
|attachmentExists||Is there an attachment that needs to be show along with the document details on the Sigmify stream?|
Possible values – Y/N
|attachmentUrl||If yes, then URL for that attachment. Mandatory if attachmentExists is Y||No|
|assignedToRoles*||The users belonging to these roles in Sigmify will be able to see this message/document details on their stream.|
One of assignedToRole or assignedToUsers needs to have values.
|assignedToUsers*||These users will be able to see this message/document details on their stream. One of assignedToRole or assignedToUsers needs to have values||Yes/No|
|Completedby*||The Code of the user who has performed/completed the current document. Mandatory when the messageStatus is D||Yes/No|
|completedDate||The date/time when the current document was completed/task was performed. Mandatory when the messageStatus is D||Yes/No|
*The third party will need to send the user and roles that are valid in Sigmify.