Create Link

Mediante este endpoint es posible generar un enlace de descarga para un archivo almacenado en el servicio. Para ello, se debe entregar el parámetro de ruta file_uuid, correspondiente al identificador único del archivo de interés. Cabe señalar que este enlace se puede generar con distintas configuraciones que serán descritas a continuación.

Field	Type	Required	Example	Description
password	String	false	Pass123	Contraseña que se tendrá que ingresar cuando se desee descargar el archivo.
max_download	Integer	false	5	Cantidad de veces que se podrá descargar el archivo.
caducity	String	false	2021-09-06 17:21:00	Fecha y hora en que caducará el enlace de descarga.

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/links/:file_uuid

caution

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

Como obtener un access token

Body

{

"password": "123456",

"max_download": 1,

"caducity":"2021-09-06 17:21:00"

}

Code Examples

Curl

curl --location --request POST 'https://api.trust.lat/chronos/v1/links/ffffffff-ffff-ffff-ffff-ffffffffffff' \

--header 'Authorization: Bearer {{access_token}}' \

--header 'Content-Type: application/json' \

--data-raw '{

"password": "123456",

"max_download": 1,

"caducity":"2021-09-06 17:21:00"

}'

JavaScript

import requests

url = "https://api.trust.lat/chronos/v1/links/ffffffff-ffff-ffff-ffff-ffffffffffff"

payload="{\n \"password\": \"123456\",\n \"max_download\": 1,\n \"caducity\":\"2021-09-06 17:21:00\"\n}"

headers = {

'Authorization': 'Bearer {{access_token}}',

'Content-Type': 'application/json'

}

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

print(response.text)

Python

var axios = require('axios');

var data = JSON.stringify({"password":"123456","max_download":1,"caducity":"2021-09-06 17:21:00"});

var config = {

method: 'post',

url: 'https://api.trust.lat/chronos/v1/links/ffffffff-ffff-ffff-ffff-ffffffffffff',

headers: {

'Authorization': 'Bearer {{access_token}}',

'Content-Type': 'application/json',

},

data : data

};

axios(config)

.then(function (response) {

console.log(JSON.stringify(response.data));

})

.catch(function (error) {

console.log(error);

});

Responses

HTTP Code: 201 Created (Simple Link)

{

"code": 201,

"resource": "Download Link",

"data": {

"link": "https://api.trust.lat/chronos/v1/file/ffffffffffffffffffffffffffffffff",

"uuid": "ffffffff-ffff-ffff-ffff-ffffffffffff",

"size": "1687.421875 KB",

"secured_by_password": false

},

"message": "Created"

}

HTTP Code: 201 Created (Created link with rules)

{

"code": 201,

"resource": "Download Link",

"data": {

"link": "https://api.trust.lat/chronos/v1/file/ffffffffffffffffffffffffffffffff",

"max_download": 1,

"uuid": "ffffffff-ffff-ffff-ffff-ffffffffffff",

"size": "1687.421875 KB",

"secured_by_password": true

},

"message": "Created"

}

HTTP Code: 404 Not Found

{

"code": 404,

"resource": "File register",

"message": "Not found"

}