Digito

Consultar la auditoría

Consulta los eventos de auditoría de un sobre con filtros de paginación y orden.

GET /envelope/{envelopeId}/audit-log

URL base: https://business.digito.do/api/v2.

Ejemplos

Configura DIGITO_API_TOKEN en el servidor. Sustituye los IDs y archivos de ejemplo por los de tu equipo. TypeScript usa fetch y FormData de Node.js.

curl --fail-with-body \
  --request GET \
  --url 'https://business.digito.do/api/v2/envelope/sobre_de_ejemplo/audit-log?page=1&perPage=10&orderByColumn=createdAt&orderByDirection=desc' \
  --header "Authorization: $DIGITO_API_TOKEN"

Autenticación

Envía el token de la API en el encabezado Authorization. El acceso corresponde al equipo y a los permisos del token. Conserva el token en tu servidor.

Authorization: api_TU_TOKEN

Antes de cada acción de firma, el firmante debe autenticarse de nuevo con Digito ID. Una sesión previa de Business, un token de destinatario o un token de la API no sustituye este requisito.

Parámetros

NombreUbicaciónTipoObligatorioRestricciones
envelopeIdRutastringSíIdentificador del sobre. Sin restricciones adicionales en este nivel.
pageConsultanumberNoNúmero de página; comienza en 1. Mínimo: 1
perPageConsultanumberNoCantidad de elementos por página. Mínimo: 1. Máximo: 100
orderByColumnConsultastringNoValores: "createdAt"
orderByDirectionConsultastringNoValores: "asc", "desc"

Cuerpo de la solicitud

Esta operación no declara cuerpo de solicitud.

Respuesta de éxito

Esta referencia muestra las propiedades documentadas para Digito. Conserva el resto de la respuesta recibida en tu aplicación.

Este objeto sintético ilustra las propiedades documentadas de una respuesta 200. Los identificadores, fechas, estados y tokens son datos de ejemplo.

{
  "data": [
    {
      "id": "recurso_de_ejemplo",
      "createdAt": "2026-10-06T12:00:00.000Z",
      "envelopeId": "sobre_de_ejemplo",
      "type": "ENVELOPE_ITEM_CREATED",
      "data": {
        "envelopeItemId": "archivo_de_ejemplo",
        "envelopeItemTitle": "valor_de_ejemplo"
      }
    }
  ],
  "count": 1,
  "currentPage": 1,
  "perPage": 10,
  "totalPages": 1
}

Respuestas y errores

EstadoDescripciónContenido y esquema
200Respuesta correcta.application/json
400Datos de entrada inválidos.application/json
401No se proporcionó autorización.application/json
403Permisos insuficientes.application/json
404Recurso no encontrado.application/json
500Error interno del servidor.application/json

Los esquemas enlazados incluyen propiedades anidadas, campos obligatorios, variantes, enumeraciones, nulabilidad y restricciones. Consulta errores y reintentos para manejar respuestas no exitosas.

Identificador de operación: envelope-auditLog-find.