get
https://app.fracttal.com/api/work_requests_attachments/:code/
Mediante este endpoint se pueden consultar todos los adjuntos (archivos y links) vinculados a las solicitudes de trabajo, o a una solicitud en específico. Cada adjunto indica su tipo en el campo type.
El parámetro de la URL code es el id de la solicitud. Se puede consultar en el endpoint de consulta de solicitudes (campo code).
GET https://app.fracttal.com/api/work_requests_attachments/:codeParámetros de entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
code | texto | No | Id de la solicitud. Se puede consultar en el endpoint de consulta de solicitudes (campo code). |
start | entero | No | Número de registro donde iniciará la consulta. Por defecto 0. Todas las consultas están limitadas a 100 registros; cuando hay más de esa cantidad se debe utilizar este parámetro para la paginación. |
limit | entero | No | Cantidad de registros que mostrará la petición. El valor por defecto es 100. |
Parámetros de salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | booleano | Indica si la petición fue exitosa. |
message | texto | Código de respuesta de la petición. |
data | array de objeto | Lista de adjuntos. Ver estructura en la tabla siguiente. |
total | entero | Cantidad total de registros. |
Estructura de cada elemento en data:
| Parámetro | Tipo | Descripción |
|---|---|---|
id | entero | Id del adjunto. |
id_company | entero | Id de la empresa. |
id_request | entero | Id de la solicitud. |
description | texto | Nombre del adjunto. |
type | entero | Tipo de adjunto: 1 = Archivo, 2 = Link. |
signed_path_image | texto | Si el adjunto es un archivo (type = 1), URL de descarga del archivo, válida por 24 horas. Si es un link (type = 2), la URL del link tal como fue registrado. |
Errores
| Código | Causa |
|---|---|
401 | Token de autenticación ausente o inválido. |
500 | Error interno al procesar la petición. |
Ejemplo
Petición: (GET) https://app.fracttal.com/api/work_requests_attachments/11
Response 200
200{
"success": true,
"message": "200",
"data": [
{
"id": 3,
"id_company": 1,
"id_request": 11,
"description": "foto_tablero_electrico.png",
"type": 1,
"signed_path_image": "https://fracttal-fs.s3.amazonaws.com/company_1/.request/11/foto_tablero_electrico.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=86400&X-Amz-Signature=abc123"
},
{
"id": 4,
"id_company": 1,
"id_request": 11,
"description": "Manual del proveedor",
"type": 2,
"signed_path_image": "https://ejemplo.com/manuales/tablero-electrico"
}
],
"total": 2
}