Skip to main content

Autosign API Reference (1.0)

Download OpenAPI specification:Download

autosign: dev@autosign.io

transaction_created Webhook

Request Body schema: application/json

Evento que se emite cuando se crea una transacción

created
required
string <date-time>

La fecha en la que se creó el evento

id
required
string

El id del evento

type
required
string
Value: "transaction_created"

El tipo de evento

required
object

La información del evento

Request samples

Content type
application/json
{
  • "created": "2024-02-16T17:02:20.635Z",
  • "id": "clsowe02k00063ol92j9sjwdp",
  • "type": "transaction_created",
  • "data": {
    }
}

transaction_started Webhook

Request Body schema: application/json

Evento que se emite cuando una transacción fue iniciada

created
required
string <date-time>

La fecha en la que se creó el evento

id
required
string

El id del evento

type
required
string
Value: "transaction_started"

El tipo de evento

required
object

La información del evento

Request samples

Content type
application/json
{
  • "created": "2024-02-16T17:38:55.563Z",
  • "id": "clsoxp1os0004105mtsl2cg22",
  • "type": "transaction_started",
  • "data": {
    }
}

transaction_completed Webhook

Request Body schema: application/json

Evento que se emite cuando una transacción fue completada

created
required
string <date-time>

La fecha en la que se creó el evento

id
required
string

El id del evento

type
required
string
Value: "transaction_completed"

El tipo de evento

required
object

La información del evento

Request samples

Content type
application/json
{}

transaction_expired Webhook

Request Body schema: application/json

Evento que se emite cuando una transacción fue expirada

created
required
string <date-time>

La fecha en la que se creó el evento

id
required
string

El id del evento

type
required
string
Value: "transaction_expired"

El tipo de evento

required
object

La información del evento

Request samples

Content type
application/json
{
  • "created": "2024-02-16T18:11:20.743Z",
  • "id": "clsoyuqlm0002gjd9d0erwubq",
  • "type": "transaction_expired",
  • "data": {
    }
}

recipient_submitted Webhook

Request Body schema: application/json

Evento que se emite cuando un destinatario ha realizado las acciones necesarias en la transacción

created
required
string <date-time>

La fecha en la que se creó el evento

id
required
string

El id del evento

type
required
string
Value: "recipient_submitted"

El tipo de evento

required
object

Request samples

Content type
application/json
{
  • "created": "2024-02-16T17:12:20.159Z",
  • "id": "clsowqwm90001gzu3qpjfpmeh",
  • "type": "recipient_submitted",
  • "data": {
    }
}

transaction_rejected Webhook

Request Body schema: application/json

Evento que se emite cuando un destinatario ha rechazado una transacción

created
required
string <date-time>

La fecha en la que se creó el evento

id
required
string

El id del evento

type
required
string
Value: "transaction_rejected"

El tipo de evento

required
object

Request samples

Content type
application/json
{
  • "created": "2024-02-16T17:41:26.268Z",
  • "id": "clsoxs9z3000s105mqswgw0im",
  • "type": "transaction_rejected",
  • "data": {
    }
}

transaction_cancelled Webhook

Request Body schema: application/json

Evento que se emite cuando una transacción fue cancelada por el remitente u otro usuario de la compañía

created
required
string <date-time>

La fecha en la que se creó el evento

id
required
string

El id del evento

type
required
string
Value: "transaction_cancelled"

El tipo de evento

required
object

La información del evento

Request samples

Content type
application/json
{
  • "created": "2024-02-16T18:11:20.743Z",
  • "id": "clsoyuqlm0002gjd9d0erwubq",
  • "type": "transaction_cancelled",
  • "data": {
    }
}

File

Subir archivo

Este endpoint te permite subir un archivo y obtener un token que representa dicho archivo dentro del cloud storage de autosign. El token retornado puede ser usado en otros endpoints al momento de vincular archivos con otros recursos (transacciones, plantillas) Se soportan todos los archivos con un peso máximo de 10 MB.

Request Body schema: multipart/form-data
required
name
string

Nombre del archivo

file
string <binary>

Archivo a subir. Máximo 10MB

Responses

Response samples

Content type
application/json
{}

Transaction

Crear transacción

Crea una transacción en estado borrador

Authorizations:
oauth2
Request Body schema: application/json
required
name
string

Nombre de la transacción

notification_endpoint
string or null <uri> <= 255 characters

Endpoint en donde autosign enviara actualizaciones sobre la transacción (Instant Transaction Notification)

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "string"
}

Actualizar campos

Actualiza los campos de los documentos de la transacción

Authorizations:
oauth2
path Parameters
transactionId
required
string

ID de la transacción

Request Body schema: application/json
required
required
Array of objects

Lista de campos

Array
guid
string or null <= 30 characters

Id opcional generado por el cliente para permitir hacer referencia al campo

document_id
required
string <cuid> non-empty

Id del documento

recipient_id
required
string <cuid> non-empty

Id del destinatario

width
required
number [ 0 .. 100 ]

Ancho del campo en porcentaje relativo a las dimensiones de la página

height
required
number [ 0 .. 100 ]

Alto del campo en porcentaje relativo a las dimensiones de la página

positionX
required
number [ 0 .. 100 ]

Posición horizontal del campo en porcentaje relativo a las dimensiones de la página

positionY
required
number [ 0 .. 100 ]

Posición vertical del campo en porcentaje relativo a las dimensiones de la página

page
required
number >= 0

Número de página

required
string or string

Etiqueta del campo

type
required
string
Enum: "email" "select" "checkbox" "text" "number" "signature" "initials" "signature_date" "company_name" "person_name" "textarea"

Tipo de campo

font_family
required
string
Enum: "roboto" "space_grotesk" "barlow_condensed" "ibm_plex_sans_condensed" "playfair_display" "roboto_condensed" "roboto_mono" "space_mono" "helvetica"

Tipo de fuente

bold
boolean
Default: false

Indica si el texto tiene que tener el estilo negrita

italic
boolean
Default: false

Indica si el texto tiene que tener el estilo cursiva

underline
boolean
Default: false

Indica si el texto tiene que tener un subrayado

font_size
required
number

Tamaño de fuente

font_color
required
string^#[0-9a-f]{3,6}$

Color de fuente. Unicamente se acepta el formato hexadecimal

required
string or string

Texto de ayuda

is_required
required
boolean

Indica si el campo es requerido

min_length
number,null or null [ 0 .. 2147483647 ]

Longitud mínima del campo. Solo aplica para campos de texto

max_length
number,null or null [ 0 .. 2147483647 ]

Longitud máxima del campo. Solo aplica para campos de texto

min_value
number,null or null [ 0 .. 2147483647 ]

Valor mínimo del campo. Solo aplica para campos numéricos

max_value
number,null or null [ 0 .. 2147483647 ]

Valor máximo del campo. Solo aplica para campos numéricos

(,null or null) or (,null or null)

Expresión regular para validar el campo. Solo aplica para campos de texto

Array of objects
Default: []

Opciones para campos de selección

signature_field_id_to_record_date
string or null

Referencia al campo de firma que se debe registrar la fecha

Responses

Request samples

Content type
application/json
{
  • "fields": [
    ]
}

Actualizar transacción

Actualiza información relacionada a la transacción

Authorizations:
oauth2
path Parameters
transactionId
required
string

ID de la transacción

Request Body schema: application/json
required
edit_navigation
boolean,null or null

Configura si el usuario podrá acceder al editor previo a enviar la transacción

required
Array of objects non-empty

Documentos de la transacción

(string or null) or string

Alias que se usara en el correo de invitación de firma

name
required
string [ 1 .. 255 ] characters

Nombre de la transacción

description
string

Descripción de la transacción

(string or null) or string

Contenido se usara en el correo de invitación de firma

(string or null) or string

Asunto se usara en el correo de invitación de firma

expiration_days
integer,null or null
required
Array of objects non-empty

Responses

Request samples

Content type
application/json
{
  • "edit_navigation": true,
  • "documents": [
    ],
  • "email_alias": "",
  • "name": "MY SAMPLE PDF",
  • "description": "",
  • "email_body": "",
  • "email_subject": "",
  • "recipients": [
    ],
  • "fields": [ ]
}

Detalle de transacción

Obtener el detalle de una transacción

Authorizations:
oauth2
path Parameters
transactionId
required
string

ID de la transacción

Responses

Response samples

Content type
application/json
{
  • "id": "clsqlgnij000fjele82l3lxz2",
  • "template_id": "clsqlgnie000cjelecsv1hfrm",
  • "created_at": "2024-02-17T21:32:00.901Z",
  • "updated_at": "2024-02-17T21:32:00.901Z",
  • "created_by_id": "clrjofqx40001raun4msulwp8",
  • "sender_id": "clrjofqx40001raun4msulwp8",
  • "provider_type": "onespan",
  • "provider_id": null,
  • "is_provider_ready": false,
  • "expiration_days": null,
  • "rejected_reason": null,
  • "rejected_at": null,
  • "rejected_by_id": null,
  • "completed_at": null,
  • "sent_at": null,
  • "expires_at": null,
  • "status": "draft",
  • "company_id": "clrjofqx20000rauna08xwd42",
  • "is_sealed": false,
  • "is_archived": false,
  • "expired_at": null,
  • "template": {
    }
}

Agregar documento

Agregar un archivo previamente subido al cloud storage de autosign como documento de una transacción

Authorizations:
oauth2
path Parameters
transactionId
required
string

ID de la transacción

Request Body schema: application/json
required
token
required
string non-empty

File token del archivo. Para subir un archivo al cloudstorage de autosign y obtener uno, observa la documentación sobre File

Responses

Request samples

Content type
application/json
{
  • "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

Response samples

Content type
application/json
{
  • "id": "clsoy7hh70005bt77pasujcpy"
}

Eliminar documento

Eliminar un documento previamente asociado a la transacción

Authorizations:
oauth2
path Parameters
documentId
required
string

ID del documento

transactionId
required
string

ID de la transacción

Responses

Usar plantillas

Instancia una o varias plantillas para la transacción

Authorizations:
oauth2
path Parameters
transactionId
required
string

ID de la transacción

Request Body schema: application/json
required
required
Array of objects non-empty

Lista de plantillas

Array (non-empty)
id
required
string non-empty

ID de la plantilla

Responses

Request samples

Content type
application/json
{
  • "templates": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "clsqlgnij000fjele82l3lxz2",
  • "template_id": "clsqlgnie000cjelecsv1hfrm",
  • "created_at": "2024-02-17T21:32:00.901Z",
  • "updated_at": "2024-02-17T21:32:00.901Z",
  • "created_by_id": "clrjofqx40001raun4msulwp8",
  • "sender_id": "clrjofqx40001raun4msulwp8",
  • "provider_type": "onespan",
  • "provider_id": null,
  • "is_provider_ready": false,
  • "expiration_days": null,
  • "rejected_reason": null,
  • "rejected_at": null,
  • "rejected_by_id": null,
  • "completed_at": null,
  • "sent_at": null,
  • "expires_at": null,
  • "status": "draft",
  • "company_id": "clrjofqx20000rauna08xwd42",
  • "is_sealed": false,
  • "is_archived": false,
  • "expired_at": null,
  • "template": {
    }
}

Empezar transacción

Empieza una transacción. Este método modifica el estado actual de la transacción a empezado.

Authorizations:
oauth2
path Parameters
transactionId
required
string

ID de la transacción

Responses

Template

Listar plantillas

Lista las plantillas de transacciones

Authorizations:
oauth2
query Parameters
search
string

Búsqueda por nombre de plantilla

limit
required
number

Cantidad de plantillas a mostrar

page
required
number

Número de página

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "meta": {
    }
}

OAuth

Exchange code for access token

Request Body schema: application/json
required
client_id
required
string non-empty

OAuth Application Client ID

client_secret
required
string non-empty

OAuth Application Client Secret

code
required
string non-empty

Authorization code

Responses

Request samples

Content type
application/json
{
  • "client_id": "string",
  • "client_secret": "string",
  • "code": "string"
}

Response samples

Content type
application/json
{
  • "access_token": "string",
  • "refresh_token": "string",
  • "expires_in": 0
}

Refresh access token

Request Body schema: application/json
required
client_id
required
string non-empty

OAuth Application Client ID

client_secret
required
string non-empty

OAuth Application Client Secret

refresh_token
required
string non-empty

Refresh token

Responses

Request samples

Content type
application/json
{
  • "client_id": "string",
  • "client_secret": "string",
  • "refresh_token": "string"
}

Response samples

Content type
application/json
{
  • "access_token": "string",
  • "expires_in": 0
}

Webhook

Crear webhook

Este endpoint te permite crear un webhook

Authorizations:
oauth2
Request Body schema: application/json
required
name
required
string [ 1 .. 255 ] characters

Nombre del webhook

endpoint
required
string <uri> non-empty

URL del webhook. Debe ser segura (TLS)

events
required
Array of strings non-empty
Items Enum: "transaction_completed" "transaction_created" "transaction_started" "transaction_expired" "transaction_rejected" "recipient_submitted" "transaction_cancelled"

La lista de eventos que deseas suscribirte

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "cjuv0v7zg0000hj6z8f0z3x4z"
}

Listar webhooks

Este endpoint te permite listar los webhooks mediante paginacion

Authorizations:
oauth2
query Parameters
limit
required
number
Example: limit=10

Numero de elementos por pagina

page
required
number
Example: page=1

Numero de pagina

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "meta": {
    }
}

Eliminar webhook

Este endpoint te permite eliminar un webhook creado

Authorizations:
oauth2
path Parameters
webhookId
required
any

Identificador del webhook

Responses