9.-Adjuntos

Manejo de Archivos Utilizados en Febos.

Contenedor Bases

Para cargar los archivos hay que seguir la siguiente estructura

febos-io/chile/[desarrollo|AMBIENTE]/archivos/adjuntos/[1-1|RUT EMPRESA]/

En donde se debe tener la precaución con el ambiente y el RUT EMPRESA de quien está cargando

URL PRE-FIRMADA

Esta URL se utiliza para poder cargar un archivo al repositorio de Febos. Para obtener esta URL se debe realizar una llamada GET al servicio de la API:

{API_URL}/herramientas/archivos <- Link a la documentación

Con los parámetros:

tipo = upload
contenType = tipo de archivo a cargar
key = ruta del archivo que se cargará, está compuesta del contenedor base descrito más arriba, seguida por el país, ambiente, ruta de la configuración, nombre, archivo, EJ:

febos-io/chile/`[desarrollo|AMBIENTE]`/archivos/adjuntos/`[1-1|RUT EMPRESA]`/{unique-id}.{extencion}

Nota: archivos cargados no tienen que tener espacios en el nombre y ruta a cargar.

Nota: Los archivos cargados en una misma ruta son sobreescritos.

Ejemplo de respuesta

{
"url": "https://febos-io.s3.amazonaws.com/c.....txt?X-Amz-Security-Token=IQo...6nss...&X-Amz-Signature=206 df...abfc",
"duracion": 248,
"hora": "2029-04-20 14:54:13.572",
"codigo": 10,
"seguimientoId": "cf0828a4-1..1b6b25a385",
 "mensaje": "Acción realizada satisfactoriamente"
}

PUT archivo adjunto

La URL obtenida en la sección anterior es una URL especial, ya que tiene un tiempo de validez, una firma asociada a la solicitud y encriptación de la autorización para cargar el archivo:

X-Amz-Security-Token = IQoJb3JpZ2luX2Vj.....3D
X-Amz-Algorithm = AWS4-HMAC-SHA256
X-Amz-Date = 20200420T132111Z
X-Amz-SignedHeaders = host
X-Amz-Expires = 899
X-Amz-Credential = ASIA4CUYL4XD46VCTH4X%....ws4_request
X-Amz-Signature = 79317...362c6a2b...63121a

Nota: Si la URL es modificada o no cumple con su estructura, la llamada PUT para cargar el archivo será rechazada

Con la URL obtenida se ocupan los datos contenidos en ella como parámetros de la
llamada y se hace el PUT del documento en la ruta indicada.

Nota: el método de subida del archivo depende de la aplicación o herramienta desde la cual se consuma la API REST

PORTAL="portal.febos.cl" #Dominio WEB desde donde estamos emulando la llamada
AMBIENTE="pruebas" #Ambiente en el cual se esta operando
EMPRESA="1-1" #Aqui va el RUT de la empresa que esta consuiento la API
TOKEN="AQUI_VA_TU_TOKEN" #Token de autorizacion para obtener acceso a las APIs de FEBOS
FILE=$1 #Este ejemplo recibe la ruta del archivo por parametro
FILE="${FILE// /_}"
f="$(basename -- $FILE)" # Obtenemos el nombre del archivo

RUTA_SUBIR="febos-io/chile/$AMBIENTE/archivos/adjuntos/$EMPRESA/test-$f"


url_pre_firmada=$(curl "https://api.febos.cl/$AMBIENTE/herramientas/archivos?dominioPortal=$PORTAL&key=$RUTA_SUBIR&tipo=upload" \
  -H "empresa: $EMPRESA" \
  -H "token: $TOKEN" \
  --compressed | jq -r '.url')


echo "SUBIR $url_pre_firmada"  


curl "$url_pre_firmada" \
  -X 'PUT' \
  -d "=@\"$1\"" \
  --compressed
## El parametro -d "=@\"$1\""  adjunta el archivo como content byte a la llamada

echo "CARGADO en el KEY: $RUTA_SUBIR"

Nota: Esta llamada no tiene un cuerpo de respuesta, solo el código HTTP de si es correcto o no