Find Device By Trust Id

Este endpoint recupera desde el servicio Index un dispositivo que tenga como identificador el valor de trust_id entregado como variable de ruta.

Endpoint

Headers

Key	Value	Description
Authorization	Bearer {{access_token}}	access_token obtained in Atenea

Method: GET
URL: https://api.trust.lat/index/v1/device/:trust_id

Path Variables:

Key	Value Example	Description
trust_id	ffffffff-ffff-ffff-ffff-ffffffffffff	Identificador de dispositivo provisto por la empresa Trust. 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/index/v1/device/ffffffff-ffff-ffff-ffff-ffffffffffff' \
--header 'Authorization: Bearer ************'

JavaScript

import requests

url = "https://api.trust.lat/index/v1/device/ffffffff-ffff-ffff-ffff-ffffffffffff"

payload={}
headers = {
  'Authorization': 'Bearer ************'
}

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/index/v1/device/ffffffff-ffff-ffff-ffff-ffffffffffff',
  headers: { 
    'Authorization': 'Bearer ************'
  }
};

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

Response Body

Data Fields

• apps: Arreglo de apps que contiene información sobre las apps relacionadas con la identidad.
• app.app_id: Identificador de la aplicación asociada.
• app.tags: Diccionario que contiene todos los nombres de tags asociados a la aplicación como llave y su valor como la información asociada a dicha llave.
• app.version: Rótulo que señala cual versión de la aplicación Trust está asociada al dispositivo.
• brand: Texto que indica la empresa manufacturadora del dispositivo.
• emulator: Valor booleano que indica si el dispositivo utilizado es una entidad real o emulada. Es true cuando el dispositivo es emulado y false cuando es real.
• imei: Texto que indica la identidad internacional de equipo móvil, es decir, el código único del dispositivo.
• location: Arreglo que representa un punto cartesiano, donde el primer valor es un número flotante corresponde a la longitud y el segundo a la latitud de la ultima ubicación registrada por el dispositivo. Ej: "location":[-70.00, -30.00].
• model: Texto que indica el nombre comercial del producto al que corresponde el dispositivo.
• system_name: Campo que indica el sistema operativo del dispositivo. Puede tomar los valores [android|ios].
• system_version: Campo que indica la versión del sistema operativo del dispositivo. En Android, se indica la versión del SDK, no del mayor release.
• trust_id: Identificador de dispositivo provisto por la empresa Trust.

Responses Examples

HTTP Code: 200 OK

Device found

{
    "code": 200,
    "resource": "Device",
    "data": [
        {
            "apps": [
                {
                    "app_id": "1",
                    "created_at": "2021-07-08T19:25:29.238Z",
                    "tags": {},
                    "updated_at": "2021-07-08T19:25:29.239Z",
                    "version": "2.0.9"
                }
            ],
            "brand": "samsung",
            "created_at": "2021-07-08T19:25:29.236Z",
            "emulator": false,
            "imei": "111111111111111",
            "location": [
                -79.376064,
                -33.05444
            ],
            "model": "sm-j610",
            "system_name": "android",
            "system_version": "28",
            "trust_id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
            "updated_at": "2021-07-08T19:25:29.241Z"
        }
    ],
    "message": "Found"
}

HTTP Code: 404 Not Found

Device not present in Index

{
    "code": 404,
    "resource": "Device",
    "message": "Not found"
}