Create File

Mediante este endpoint es posible almacenar un archivo en un servicio provisto por una compañía. Seleccionar un archivo en el campo file y rellenar los campos obligatorios indicados en el body de este endpoint.

Endpoint

Headers

Key	Value	Description
Content-Type	application/json
Authorization	Bearer {{access_token}}	access_token obtained in Atenea

Url

Method: POST
URL: https://api.trust.lat/chronos/v1/file_registers/

caution

Recuerda que para utilizar este endpoint es necesario un access token obtenido en el servicio Atenea

Como obtener un access token

Body

Nota: Este endpoint se utiliza mediante un form-data

Field	Type Data	Value	Description
file	File	text.txt	Archivo que se desea subir al servicio.
company_id	Text	1	Identificador de la compañía que desea utilizar el servicio.
tags	Text	{"foo":"bar"}	Etiqueta con la que se puede localizar el archivo.
service_name	Text	default_name	Nombre del servicio asociado a la compañía a través del que se desea almacenar el archivo.
folder	Text	prototype	Carpeta contenedora del archivo. Opcional

Code Examples

Curl

curl --location --request POST 'https://api.trust.lat/chronos/v1/file_registers/' \
--header 'Authorization: Bearer `{{access_token}}`' \
--form 'file=@"test/ciervo.jpg"' \
--form 'company_id="1"' \
--form 'service_name="default_name"'

JavaScript

import requests

url = "https://api.trust.lat/chronos/v1/file_registers/"

payload={'company_id': '1',
'service_name': 'default_name'}
files=[
  ('file',('ciervo.jpg',open('test/ciervo.jpg','rb'),'image/jpeg'))
]
headers = {
  'Authorization': 'Bearer `{{access_token}}`'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Python

var axios = require('axios');
var FormData = require('form-data');
var fs = require('fs');
var data = new FormData();
data.append('file', fs.createReadStream('test/ciervo.jpg'));
data.append('company_id', '1');
data.append('service_name', 'test_service');

var config = {
  method: 'post',
  url: 'https://api.trust.lat/chronos/v1/file_registers/',
  headers: { 
    'Authorization': 'Bearer `{{access_token}}`', 
    ...data.getHeaders()
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Responses

HTTP Code: 201 Created

{
    "code": 201,
    "resource": "File",
    "data": {
        "uuid": "94d2e912-326f-46c8-9ee9-93f2c8bd2ddd",
        "name": "ciervo.jpg",
        "size": "206.2080078125 KB",
        "created_at": "2021-09-24T21:13:33.109Z",
        "tags": {},
        "path": "ciervo.jpg"
    },
    "message": "Created"
}

HTTP Code: 404 Not Found (Missing Service Config)

{
    "code": 404,
    "resource": "Service Config",
    "message": "Not found"
}

HTTP Code: 404 Not Found (Missing File to Upload)

{
    "code": 404,
    "resource": "File to upload",
    "message": "Not found"
}

HTTP Code: 422 Unprocessable Entity

{
    "code": 422,
    "resource": "File Register",
    "message": "Fail",
    "errors": "Tags must be formatted as a Map<String:String> and contain at least one new key/value"
}