Inicio rápido

Crear una clave API

Abre Configuración → Claves API en la aplicación web y crea una clave con spaces:read y documents:write. El secreto se muestra una sola vez; cópialo en tu almacén de secretos.

export ADLASS_API_KEY='adl_live_…'

Para desarrollo usa https://dev.adlass.io/v1, la aplicación web de desarrollo y una clave adl_test_. Cada entorno acepta solo sus propias claves.

Listar tus spaces

curl https://api.adlass.io/v1/spaces \
  -H "Authorization: Bearer $ADLASS_API_KEY"

La respuesta contiene items y next_cursor. Elige un ID de space para el siguiente paso.

Registrar una subida

Las escrituras necesitan un Idempotency-Key; los SDKs lo añaden automáticamente.

curl https://api.adlass.io/v1/documents \
  -H "Authorization: Bearer $ADLASS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"space_id":"SPACE_UUID","file_name":"informe.pdf","content_type":"application/pdf","file_size":1024}'

Subir el archivo y confirmar

Solicita una URL prefirmada con GET /documents/{document_id}/upload-url, sube el archivo con PUT a presigned_url y luego llama a POST /documents/{document_id}/confirm-upload con un nuevo Idempotency-Key. La respuesta 202 incluye una cabecera Location que apunta al trabajo de procesamiento; consúltalo hasta que el estado sea COMPLETED.