/** * Dropsigner *
In order to call this APIs, you will need an API key. Set the API key in the header X-Api-Key:
X-Api-Key: your-app|xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
The APIs will return the following HTTP codes:
| Code | Description |
|---|---|
| 200 (OK) | Request processed successfully. The response is different for each API, please refer to the operation's documentation |
| 400 (Bad Request) | Syntax error. For instance, when a required field was not provided |
| 401 (Unauthorized) | API key not provided or invalid |
| 403 (Forbidden) | API key is valid, but the application has insufficient permissions to complete the requested operation |
| 422 (Unprocessable Entity) | API error. The response is as defined in ErrorModel |
Some of the error codes returned in a 422 response are provided bellow*:
*The codes shown above are the main error codes. Nonetheless, this list is not comprehensive. New codes may be added anytime without previous warning.
It is recomended to subscribe to Webhook events instead of polling APIs. To do so, enable webhooks and register an URL that will receive a POST request whenever one of the events bellow occur.
All requests have the format described in Webhooks.WebhookModel. The data field varies according to the webhook event type:
| Event type | Description | Payload |
|---|---|---|
| DocumentSigned | Triggered when a document is signed. | Webhooks.DocumentSignedModel |
| DocumentApproved | Triggered when a document is approved. | Webhooks.DocumentApprovedModel |
| DocumentRefused | Triggered when a document is refused. | Webhooks.DocumentRefusedModel |
| DocumentConcluded | Triggered when the flow of a document is concluded. | Webhooks.DocumentConcludedModel |
| DocumentCanceled | Triggered when the document is canceled. | Webhooks.DocumentCanceledModel |
| DocumentExpired (v1.33.0) | Triggered when the document is expired. | Webhooks.DocumentExpiredModel |
| DocumentsCreated (v1.50.0) | Triggered when one or more documents are created. | Webhooks.DocumentsCreatedModel |
| DocumentsDeleted (v1.78.0) | Triggered when one or more documents are deleted. | Webhooks.DocumentsDeletedModel |
To register your application URL and enable Webhooks, access the integrations section in your organization's details page.
* * OpenAPI spec version: 2.6.0 * * * NOTE: This class is auto generated by the swagger code generator program. * https://github.com/swagger-api/swagger-codegen.git * Do not edit the class manually. */ /** * * @export * @interface DocumentsActionUrlRequest */ export interface DocumentsActionUrlRequest { /** * The identifier (CPF in Brazil or Cédula de Identidad in Ecuador/Paraguay) of the participant to whom you want to get the ticket. * @type {string} * @memberof DocumentsActionUrlRequest */ identifier?: string | null; /** * The email of the participant to whom you want to get the ticket. * @type {string} * @memberof DocumentsActionUrlRequest */ emailAddress?: string | null; /** * If action is an electronic signature and this parameter is set to true, requires e-mail authentication with code in order to complete the signature. * @type {boolean} * @memberof DocumentsActionUrlRequest */ requireEmailAuthentication?: boolean; /** * The ID of the flow action for which the ticket will be generated. It should only be provided if there are more than one pending action for the participant. * @type {string} * @memberof DocumentsActionUrlRequest */ flowActionId?: string | null; }