Archivos de lead y negocio
Esta página cubre los endpoints de archivos asociados a leads y negocios: leer un archivo de lead almacenado, adjuntar archivos de onboarding de negocio y listar los documentos de un negocio.
Leer un archivo de lead
Obtiene el contenido de un archivo previamente almacenado para un lead. El archivo se identifica por su segmento de ruta fileName. Este endpoint no recibe cuerpo de solicitud — es una lectura, no una carga.
curl -X POST "https://api.ali.app/rest/leads/files/upload/identification.pdf" \
-H "Authorization: Bearer <token>" \
-H "x-application-id: YOUR_APP_ID"
| Campo | Dónde | Requerido |
|---|---|---|
fileName | Ruta de la URL | ✅ — el nombre del archivo almacenado |
fileName se trata como un nombre de archivo almacenado de formato libre; no hay una lista enumerada de espacios ni un checklist de documentos en la respuesta. Requiere el permiso FILE_UPLOAD.
Adjuntar archivos a un negocio
Una vez que un lead ha sido promovido a un negocio, adjunta sus archivos de onboarding mediante form-data multipart. Ambos campos son archivos y ambos son requeridos (máx. 1 cada uno).
curl -X POST "https://api.ali.app/rest/businesses/{commerceId}/files" \
-H "Authorization: Bearer <token>" \
-F "businessPhoto=@photo.jpg" \
-F "utilityBill=@bill.pdf"
| Campo | Tipo | Requerido |
|---|---|---|
businessPhoto | archivo (multipart) | ✅ |
utilityBill | archivo (multipart) | ✅ |
commerceId es un identificador numérico.
Listar documentos del negocio
curl "https://api.ali.app/rest/businesses/{commerceId}/docs" \
-H "Authorization: Bearer <token>"
Devuelve los documentos del comercio como URLs firmadas de corta duración.