Update File
Endpoint que permite asociar y subir una nueva versión del archivo identificado por el uuid dado en la variable de ruta. Para ello, incorporar el nuevo archivo en el campo file. Además, es posible asignar nuevos tags y mover el archivo a una nueva carpeta, siempre y cuando se entregue esta información en el body, respetando el formato de estos campos. (Los tags deben ingresarse en una estructura Map<String:String>
y la carpeta debe contener sólo carácteres alfanuméricos y guiones).
Endpoint
Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json | |
Authorization | Bearer {{access_token}} | access_token obtained in Atenea |
Url
Method: PUT
URL: https://api.trust.lat/chronos/v1/file_registers/:uuid
caution
Recuerda que para utilizar este endpoint es necesario un access token obtenido en el servicio Atenea
Body
Nota: Este endpoint se utiliza mediante un form-data y los campos que se pueden actualizar son los siguientes:
Field | Type Data | Value | Description |
---|---|---|---|
file | File | dog.jpg | Nueva versión del archivo indicado por la variable de ruta. |
folder | Text | prototype | Carpeta contenedora del archivo. Opcional |
tags | Text | {"foo":"bar"} | Etiquetas clasificadoras asignadas al archivo. Opcional |
Code Examples
- Curl
- JavaScript
- Python
curl --location -g --request PUT 'https://api.trust.lat/chronos/v1/file_registers/ffffffff-ffff-ffff-ffff-ffffffffffff' \
--form 'file=@"test/cow.jpg"'
import requests
url = "https://api.trust.lat/chronos/v1/file_registers/ffffffff-ffff-ffff-ffff-ffffffffffff"
payload={}
files=[
('file',('cow.jpg',open('test/cow.jpg','rb'),'image/jpeg'))
]
headers = {}
response = requests.request("PUT", url, headers=headers, data=payload, files=files)
print(response.text)
var axios = require('axios');
var FormData = require('form-data');
var fs = require('fs');
var data = new FormData();
data.append('file', fs.createReadStream('test/cow.jpg'));
var config = {
method: 'put',
url: 'https://api.trust.lat/chronos/v1/file_registers/ffffffff-ffff-ffff-ffff-ffffffffffff',
headers: {
...data.getHeaders()
},
data : data
};
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});
Responses
HTTP Code: 200 OK
{
"code": 200,
"resource": "File Register",
"data": {
"name": "cow.jpg",
"size": "0.045 KB",
"uuid": "ffffffff-ffff-ffff-ffff-ffffffffffff",
"created_at": "2021-09-24T19:35:22.007Z",
"tags": {},
"path": "cow.jpg"
},
"message": "Updated"
}
HTTP Code: 404 Not Found
{
"code": 404,
"resource": "File to upload",
"message": "Not found"
}