Get Tags Of Person By Company

Este endpoint permite obtener los tags (y sus valores asignados) de una persona específica que pertenece a una compañia dada. Para identificar a la persona, es necesario incorporar por lo menos uno de los siguientes campos en la request [email|dni].

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/index/v1/company/:company_id/persons/tags

Path Variables:

Key	Value Example	Description
company_id	99	Identificador de compañia provisto por 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

Body

Fields

• email: Correo de la persona. Parcialmente Obligatorio.
• dni: Identificador nacional de una persona. Parcialmente Obligatorio.

Example

{

"dni": "12345678-9",

"email":"abeta@example.test"

}

Code Examples

Curl

curl --location --request GET 'https://api.trust.lat/index/v1/company/99/persons/tags' \

--header 'Authorization: Bearer ************' \

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

--data-raw '{

"dni": "12345678-9",

"email": "abeta@example.test"

}'

JavaScript

import requests

url = "https://api.trust.lat/index/v1/company/99/persons/tags"

payload="{\n \"dni\": \"12345678-9\",\n \"email\": \"abeta@example.test\"\n}"

headers = {

'Authorization': 'Bearer ************',

'Content-Type': 'application/json'

}

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

print(response.text)

Python

var axios = require('axios');

var data = JSON.stringify({"dni":"12345678-9","email":"abeta@example.test"});

var config = {

method: 'get',

url: 'https://api.trust.lat/index/v1/company/99/persons/tags',

headers: {

'Authorization': 'Bearer ************',

'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: 200 OK

Tags of person from company found

{

"code": 200,

"resource": "PersonsTags",

"data": {

"company_uid": "99",

"created_at": "2021-07-09T20:14:51.127Z",

"dni": "12345678-9",

"email": "abeta@example.test",

"tags": {

"systemic_sub_company": "ffffffff-ffff-ffff-ffff-ffffffffffff"

},

"updated_at": "2021-07-09T20:15:20.395Z"

},

"message": "Found"

}

HTTP Code: 404 Not Found

Company not present in Trust Services

{

"code": 404,

"resource": "PersonsTags",

"message": "Not found"

}

Missing person fields

{

"code": 404,

"resource": "PersonsTags",

"message": "Not found"

}