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"
}