Autorizar la subida de un archivo

Crea un flujo de subida acotado para un archivo de origen privado.

Autenticación

Clave de API

Permisos

files:write

Contrato

API v1

Solicitud

curl -X POST 'https://api.maxscanner.app/api/v1/files/upload' \
  -H 'Authorization: Bearer $MAXSCANNER_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: unique-request-id' \
  -d '{ "filename": "scan.pdf", "contentType": "application/pdf", "sizeBytes": 1048576 }'

Cuerpo de la solicitud

{ "filename": "scan.pdf", "contentType": "application/pdf", "sizeBytes": 1048576 }

Respuesta

{ "uploadUrl": "…", "sourceKey": "…", "expiresAt": "…" }

Notas de implementación

Las URL de subida son de corta duración.
Valida el tamaño y el tipo del archivo antes de procesarlo.

Prueba este endpoint

Usa el entorno de pruebas de la API para autenticarte y probar con seguridad antes de integrar el endpoint en tu aplicación.

Abrir el entorno de pruebas →