get
https://app.fracttal.com/api/work_orders_attachments/:folio/
Mediante este EndPoint se puede consultar los adjuntos vinculados a una orden de trabajo.
Para hacer uso de este EndPoint es necesario contar con el ADD-ON de API Avanzada.
Parámetros de entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
folio | Entero | Si | Id de la OT. Se puede consultar aquí. (campo wo_folio) |
id_work_order_task | Entero | Opcional | Id de la tarea dentro de la orden de trabajo. Se puede consultar aquí. (campo id_work_orders_tasks) |
type | Entero | Opcional | Tipo de adjunto (1-Archivo, 3-Nota, 2-Link) |
start | Entero | Opcional | 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 | Opcional | Cantidad de registros que mostrará la petición. El valor por defecto es 100. |
Nota:
Si se envía el parámetro id_work_order_task, la consulta filtrará los adjuntos correspondientes a esa tarea específica.
Si no se envía, se retornarán todos los adjuntos asociados a la orden de trabajo (OT).
Los archivos no se entregan como binario directo. En su lugar, se retorna una URL firmada de S3.
Estas URLs tienen un tiempo de expiración, por lo que el consumidor debe descargar los archivos lo antes posible antes de que caduquen.
Parámetros de salida
| Parámetro | Tipo | Descripción |
|---|---|---|
id_work_order_task | Entero | Id de la tarea dentro de la orden de trabajo |
id_company | Entero | Id de la empresa |
wo_folio | Entero | Folio de la OT |
type | Entero | Tipo de adjunto( 1-Archivo, 3-Nota, 2-Link) |
description | Texto | Descripción del adjunto |
value | Texto | Dirección del adjunto |
Ejemplo:
Petición: (GET)https://app.fracttal.com/api/work_orders_attachments/OTPRB8612019?id_work_order_task=7077133
{
"success": true,
"message": "200",
"data": [
{
"description": "",
"value": "https://fracttal-fs.s3.amazonaws.com/company_1190/.ot/7077133/FB_IMG_1618664297806.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJFGNA53BIGD7KR2A%2F20220809%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20220809T205958Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=11b7f37e21f4393298d0d3347d814efb502ff7092849d21e7cff91672f7951aa",
"type": 1,
"id_work_order_task": 7077133,
"wo_folio": "OTPRB8612019",
"id_company": 1190
},
{
"description": "Nuevo1",
"value": "https://fracttal-fs.s3.amazonaws.com/company_1190/.ot/7077133/FB_IMG_1626372957794.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJFGNA53BIGD7KR2A%2F20220809%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20220809T205958Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=416eae817861b6ac2ce0ac35ff837cf4bdb341d9c5397ce2cb377fa1af60468d",
"type": 1,
"id_work_order_task": 7077133,
"wo_folio": "OTPRB8612019",
"id_company": 1190
},
{
"description": "Adj off 1",
"value": "https://fracttal-fs.s3.amazonaws.com/company_1190/.ot/3726532/1650458146548-photo.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJFGNA53BIGD7KR2A%2F20220809%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20220809T205958Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=2513e64ec59ac086f03a8cc39653812da8d3331f7c7880ee69dc1fa693c68f4c",
"type": 1,
"id_work_order_task": 7077133,
"wo_folio": "OTPRB8612019",
"id_company": 1190
},
{
"description": "Adj off 2",
"value": "https://fracttal-fs.s3.amazonaws.com/company_1190/.ot/3726532/1650458158097-photo.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJFGNA53BIGD7KR2A%2F20220809%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20220809T205958Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=6bfee2c6a65515e96808861c49f2a89bc1b619526117cece504be7a1523c18e5",
"type": 1,
"id_work_order_task": 7077133,
"wo_folio": "OTPRB8612019",
"id_company": 1190
},
{
"description": "Adj off 3",
"value": "https://fracttal-fs.s3.amazonaws.com/company_1190/.ot/3726532/Screenshot_20220303_001531_com.facebook.katana.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJFGNA53BIGD7KR2A%2F20220809%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20220809T205958Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=1e121ddc77eebd6615ba3a2047e86364cd0c501f7b6f72af7a4f6851fe4df7e6",
"type": 1,
"id_work_order_task": 7077133,
"wo_folio": "OTPRB8612019",
"id_company": 1190
},
{
"description": "Link",
"value": "https://unlink.com",
"type": 2,
"id_work_order_task": 7077133,
"wo_folio": "OTPRB8612019",
"id_company": 1190
},
{
"description": "Nota",
"value": "Adj 4 ok",
"type": 3,
"id_work_order_task": 7077133,
"wo_folio": "OTPRB8612019",
"id_company": 1190
}
],
"total": 7
}