Download Links By File

Este endpoint permite realizar una búsqueda avanzada de enlaces de descarga de un archivo, con la posibilidad de filtrar los resultados utilizando la fecha de creación de éstos. Como respuesta se da un arreglo con los enlaces de descarga que cumplen el criterio de búsqueda planteado. Por defecto, los valores de page y per_page son 1 y 5 respectivamente, y si no se indica un intervalo de tiempo, se retornan todos los enlaces activos asociados al archivo.

Endpoint

Headers

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

Method: GET
URL: https://api.trust.lat/chronos/v1/file_registers/:file_uuid/links?page=&per_page=&from_date=&until_date=

Query Params:

Key	Value Example	Description
page	1	Número de la página que se desea observar. Opcional
per_page	5	Cuántos elementos por página hay que mostrar. Opcional
from_date	2021-09-16 16:33:25	Fecha de inicio de búsqueda. Opcional
until_date	2021-09-18 16:33:28	Fecha límite de búsqueda. Opcional

Path Variables:

Key	Value Example	Description
file_uuid	ffffffff-ffff-ffff-ffff-ffffffffffff	Identificador único del archivo, provisto por servicio Chronos. Obligatorio

caution

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

Como obtener un access token

Code Examples

Curl

curl --location --request GET 'https://api.trust.lat/chronos/v1/file_registers/:file_uuid/links?page=1&per_page=5&from_date=2021-09-16%2016:33:25&until_date=2021-09-18%2016:33:28' \
--header 'Authorization: Bearer `{{access_token}}`'

JavaScript

import requests

url = "https://api.trust.lat/chronos/v1/file_registers/:file_uuid/links?page=1&per_page=5&from_date=2021-09-16 16:33:25&until_date=2021-09-18 16:33:28"

payload={}
headers = {
  'Authorization': 'Bearer `{{access_token}}`'
}

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

print(response.text)

Python

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://api.trust.lat/chronos/v1/file_registers/:file_uuid/links?page=1&per_page=5&from_date=2021-09-16 16:33:25&until_date=2021-09-18 16:33:28',
  headers: { 
    'Authorization': 'Bearer `{{access_token}}`'
  }
};

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

Responses

HTTP Code: 200 OK

Download Links retrieved successfully

{
    "code": 200,
    "resource": "Download Links",
    "data": [
        {
            "link": "https://api.trust.lat/chronos/v1/file/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
            "max_download": 1,
            "uuid": "ffffffff-ffff-ffff-ffff-ffffffffffff",
            "size": "1687.421875 KB",
            "secured_by_password": true
        },
        {
            "link": "https://api.trust.lat/chronos/v1/file/cccccccccccccccccccccccccccccccc",
            "uuid": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
            "size": "1687.421875 KB",
            "secured_by_password": false
        }
    ],
    "message": "Found",
    "page": 1,
    "per_page": 5,
    "total": 2
}

Request successful, no download links found

{
    "code": 200,
    "resource": "Download Links",
    "data": [],
    "message": "Found",
    "page": 1,
    "per_page": 5,
    "total": 0
}

HTTP Code: 404 Not Found

Not file associated to the file_uuid indicated

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