/**
* Dropsigner
*
Authentication
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
HTTP Codes
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 |
Error Codes
Some of the error codes returned in a 422 response are provided bellow*:
- CertificateNotFound
- DocumentNotFound
- FolderNotFound
- CpfMismatch
- CpfNotExpected
- InvalidFlowAction
- DocumentInvalidKey
*The codes shown above are the main error codes. Nonetheless, this list is not comprehensive. New codes may be added anytime without previous warning.
Webhooks
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:
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.
*/
import { AxiosResponse, AxiosInstance, AxiosRequestConfig } from 'axios';
import { Configuration } from '../configuration';
import { RequestArgs, BaseAPI } from '../base';
import { DocumentMarkMarksSessionCreateRequest } from '../models';
import { DocumentMarkMarksSessionCreateResponse } from '../models';
import { DocumentMarkMarksSessionModel } from '../models';
import { DocumentsCreateDocumentRequest } from '../models';
/**
* MarksSessionsApi - axios parameter creator
* @export
*/
export declare const MarksSessionsApiAxiosParamCreator: (configuration?: Configuration) => {
/**
* The purpose of the positioning session is to allow users to visually position signer marks. The result of the session is the same request provided while creating it but with the flowAction's prePositioned marks attribute filled according to the positions selected for each action. Result will be available by iFrame event when embedding the positioning session or by retrieving the session information via the GET API.
* @summary Creates a mark positioning session from a Document create request.
* @param {DocumentsCreateDocumentRequest} [body]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
apiMarksSessionsDocumentsPost: (body?: DocumentsCreateDocumentRequest, options?: AxiosRequestConfig) => Promise;
/**
*
* @summary Retrieves session information.
* @param {string} id The session ID obtained when the session was created
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
apiMarksSessionsIdGet: (id: string, options?: AxiosRequestConfig) => Promise;
/**
* The purpose of the positioning session is to allow users to visually position signer marks. The result of the session is the same request provided while creating it but with the flowAction's prePositioned marks attribute filled according to the positions selected for each action. Result will be available by iFrame event when embedding the positioning session or by retrieving the session information via the GET API.
* @summary Creates a mark positioning session by requiring only the necessary data.
* @param {DocumentMarkMarksSessionCreateRequest} [body]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
apiMarksSessionsPost: (body?: DocumentMarkMarksSessionCreateRequest, options?: AxiosRequestConfig) => Promise;
};
/**
* MarksSessionsApi - functional programming interface
* @export
*/
export declare const MarksSessionsApiFp: (configuration?: Configuration) => {
/**
* The purpose of the positioning session is to allow users to visually position signer marks. The result of the session is the same request provided while creating it but with the flowAction's prePositioned marks attribute filled according to the positions selected for each action. Result will be available by iFrame event when embedding the positioning session or by retrieving the session information via the GET API.
* @summary Creates a mark positioning session from a Document create request.
* @param {DocumentsCreateDocumentRequest} [body]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
apiMarksSessionsDocumentsPost(body?: DocumentsCreateDocumentRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => Promise>>;
/**
*
* @summary Retrieves session information.
* @param {string} id The session ID obtained when the session was created
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
apiMarksSessionsIdGet(id: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => Promise>>;
/**
* The purpose of the positioning session is to allow users to visually position signer marks. The result of the session is the same request provided while creating it but with the flowAction's prePositioned marks attribute filled according to the positions selected for each action. Result will be available by iFrame event when embedding the positioning session or by retrieving the session information via the GET API.
* @summary Creates a mark positioning session by requiring only the necessary data.
* @param {DocumentMarkMarksSessionCreateRequest} [body]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
apiMarksSessionsPost(body?: DocumentMarkMarksSessionCreateRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => Promise>>;
};
/**
* MarksSessionsApi - factory interface
* @export
*/
export declare const MarksSessionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
/**
* The purpose of the positioning session is to allow users to visually position signer marks. The result of the session is the same request provided while creating it but with the flowAction's prePositioned marks attribute filled according to the positions selected for each action. Result will be available by iFrame event when embedding the positioning session or by retrieving the session information via the GET API.
* @summary Creates a mark positioning session from a Document create request.
* @param {DocumentsCreateDocumentRequest} [body]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
apiMarksSessionsDocumentsPost(body?: DocumentsCreateDocumentRequest, options?: AxiosRequestConfig): Promise>;
/**
*
* @summary Retrieves session information.
* @param {string} id The session ID obtained when the session was created
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
apiMarksSessionsIdGet(id: string, options?: AxiosRequestConfig): Promise>;
/**
* The purpose of the positioning session is to allow users to visually position signer marks. The result of the session is the same request provided while creating it but with the flowAction's prePositioned marks attribute filled according to the positions selected for each action. Result will be available by iFrame event when embedding the positioning session or by retrieving the session information via the GET API.
* @summary Creates a mark positioning session by requiring only the necessary data.
* @param {DocumentMarkMarksSessionCreateRequest} [body]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
*/
apiMarksSessionsPost(body?: DocumentMarkMarksSessionCreateRequest, options?: AxiosRequestConfig): Promise>;
};
/**
* MarksSessionsApi - object-oriented interface
* @export
* @class MarksSessionsApi
* @extends {BaseAPI}
*/
export declare class MarksSessionsApi extends BaseAPI {
/**
* The purpose of the positioning session is to allow users to visually position signer marks. The result of the session is the same request provided while creating it but with the flowAction's prePositioned marks attribute filled according to the positions selected for each action. Result will be available by iFrame event when embedding the positioning session or by retrieving the session information via the GET API.
* @summary Creates a mark positioning session from a Document create request.
* @param {DocumentsCreateDocumentRequest} [body]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
* @memberof MarksSessionsApi
*/
apiMarksSessionsDocumentsPost(body?: DocumentsCreateDocumentRequest, options?: AxiosRequestConfig): Promise>;
/**
*
* @summary Retrieves session information.
* @param {string} id The session ID obtained when the session was created
* @param {*} [options] Override http request option.
* @throws {RequiredError}
* @memberof MarksSessionsApi
*/
apiMarksSessionsIdGet(id: string, options?: AxiosRequestConfig): Promise>;
/**
* The purpose of the positioning session is to allow users to visually position signer marks. The result of the session is the same request provided while creating it but with the flowAction's prePositioned marks attribute filled according to the positions selected for each action. Result will be available by iFrame event when embedding the positioning session or by retrieving the session information via the GET API.
* @summary Creates a mark positioning session by requiring only the necessary data.
* @param {DocumentMarkMarksSessionCreateRequest} [body]
* @param {*} [options] Override http request option.
* @throws {RequiredError}
* @memberof MarksSessionsApi
*/
apiMarksSessionsPost(body?: DocumentMarkMarksSessionCreateRequest, options?: AxiosRequestConfig): Promise>;
}