Digito

Listar carpetas

Busca carpetas mediante filtros y paginación.

GET /folder

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/folder?page=1&perPage=10&type=DOCUMENT' \
  --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
queryConsultastringNoTexto de búsqueda. 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
parentIdConsultastringNoSin restricciones adicionales en este nivel.
typeConsultastringNoValores: "DOCUMENT", "TEMPLATE"

Cuerpo de la solicitud

Esta operación no declara cuerpo de solicitud.

Respuesta de éxito

Este objeto sintético ilustra la estructura completa de una respuesta 200. Los identificadores, fechas, estados y tokens son datos de ejemplo.

{
  "data": [
    {
      "id": "carpeta_de_ejemplo",
      "name": "Contratos",
      "userId": 1,
      "teamId": 1,
      "parentId": null,
      "pinned": true,
      "createdAt": "2026-10-06T12:00:00.000Z",
      "updatedAt": "2026-10-06T12:00:00.000Z",
      "visibility": "EVERYONE",
      "type": "DOCUMENT"
    }
  ],
  "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: folder-findFolders.