Generar URL de descarga de un documento propio

POST

/drivers/me/documents/download-url

curl --request POST \
  --url https://api.dev.lade.com.mx/drivers/me/documents/download-url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "folder": "drivers-files", "fileName": "licencia.pdf" }'

• Development environment (dominio custom)
• QA environment
• Production environment
• Development environment (legacy — execute-api URL directo)

Equivalente driver-scoped de /dms/download-url — mismo aislamiento de authorizer que /drivers/me/documents/upload-url. Solo permite descargar objetos bajo la propia carpeta del conductor (drivers-profile/{driverId}/..., drivers-files/{driverId}/...), nunca un key arbitrario.

Authorizations

• cognitoDriversAuth

Request Body^required

Media typeapplication/json

object

folder

required

string

Allowed values: drivers-profile drivers-files

fileName

required

string

Example

{
  "folder": "drivers-files",
  "fileName": "licencia.pdf"
}

Responses

200

URL de descarga. Si la carpeta es drivers-profile (bucket público de assets) devuelve la URL pública directa; si es drivers-files devuelve una URL prefirmada que expira en 900s

Media typeapplication/json

object

downloadUrl

string format: uri

Example

{
  "downloadUrl": "https://lade-dev-documents.s3.amazonaws.com/drivers-files/770e8400.../licencia.pdf?X-Amz-Signature=..."
}

400

Solicitud inválida

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

401

No autenticado

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Unauthorized",
  "message": "Invalid or expired token"
}

403

Sin permisos

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}