Listar archivos de una entidad

GET

/dms/files

curl --request GET \
  --url 'https://api.dev.lade.com.mx/dms/files?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&entityType=DRIVER&entityId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'Authorization: Bearer <token>'

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

Lista los archivos registrados para una entidad (conductor, vehículo, cliente, etc.), con URL de descarga ya resuelta.

Authorizations

• cognitoAuth

Parameters

Query Parameters

teamId

required

string format: uuid

entityType

string

Allowed values: DRIVER VEHICLE CLIENT USER TEAM

entityId

required

string format: uuid

Responses

200

Archivos de la entidad

Media typeapplication/json

object

files

Array<object>

Metadato de un archivo subido vía DMS (el binario vive en S3, esto es el registro en DynamoDB)

object

fileId

string format: uuid

teamId

string format: uuid

entityType

string

Allowed values: DRIVER VEHICLE CLIENT USER TEAM

entityId

string format: uuid

key

S3 key

string

bucket

string

Allowed values: assets documents

fileName

string

contentType

string

size

integer

uploadedBy

string format: uuid

uploadedAt

string format: date-time

url

URL pública (CloudFront) si bucket=assets, o URL prefirmada de 900s si bucket=documents

string

Example

{
  "files": [
    {
      "fileId": "gg0e8400-e29b-41d4-a716-446655440011",
      "entityType": "DRIVER",
      "entityId": "770e8400-e29b-41d4-a716-446655440002",
      "fileName": "licencia.pdf",
      "bucket": "documents",
      "url": "https://lade-dev-documents.s3.amazonaws.com/drivers/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"
}

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"
}