Obtener token

Para utilizar la API de Trazo es necesario la obtención de un token de acceso necesario para hacer llamados a otros de los servicios disponibles.

Para utilizar cualquier servicio disponible en Trazo, es necesario contar con un token de acceso que autorice la solicitud.

La autenticación se realiza mediante el protocolo OAuth 2.0. Primero, debes solicitar un código de autorización y, con ese código, realizar una nueva solicitud para obtener el token de acceso.

Flujo de autenticación y uso de servicios

---

Obtener código de autorización

GET /v1/merchant/oauth

Parámetros

Name	Type	Description
client_id*	string	Identificador asignado al comercio
client_secret_key*	string	Clave o secreto asignado al comercio

Respuesta

200 OK

{
    "token": "ZHavAS[...]RXSqSUFoqw=="
}

401 Unauthorized

{
    "code": "Q0041-a12f2",
    "error": "The authorization is not in the correct format or does not exist."
}

---

¿Cómo usarlo?

cURL

curl --request GET '{{base-url}}/v1/merchant/oauth?client_id={{client_id}}&client_secret_key={{client_secret_key}}'

NodeJs - Axios

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: '{{base-url}}/v1/merchant/oauth?client_id={{client_id}}&client_secret_key={{client_secret_key}}'
headers: { }
};

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

Python - Requests

import requests

url = "{{base-url}}/v1/merchant/oauth?client_id={{client_id}}&client_secret_key={{client_secret_key}}"

payload = {}
headers = {}

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

print(response.text)

---

Después de obtener el código de autenticación, utilizando el método de autenticación Bearer Token puede obtener el token de acceso para hacer uso de los servicios de la API de Trazo.

Alternativamente, puedes omitir el paso anterior utilizando una combinación codificada en base64, donde el client_id actúa como el nombre de usuario y el client_secret_key como la contraseña. La estructura de la combinación en base64 se presenta de la siguiente manera: Bearer base64(client_id|client_secret_key).

---

Obtener token de acceso

GET /token

Encabezado

Name	Type	Description
Authorization *	String	Bearer {{base64(client_id|client_secret_key)}}

200 OK

{
    "access_token": "das87afwh19f82fgj192f82fdh",
    "expires_in": 3600
}

401 Unauthorized

{
    "code": "Q0141-a12f2",
    "error": "The authorization is not in the correct format or does not exist."
}

---

¿Cómo usarlo?

cURL

curl --request GET '{{base-url}}/v1/merchant/token' \
--header 'Authorization: Bearer {{oauth}}'

NodeJs - Axios

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: '{{base-url}}/v1/merchant/token'
  headers: { 
    'Authorization': 'Bearer {{oauth}}'
  }
};

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

Python - Requests

import requests

url = "{{base-url}}/v1/merchant/token"

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

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

print(response.text)

TIP! ¿Cómo usar estos ejemplos en Postman? 💡

1. Para usar este cURL puedes ingresar a Postman y seleccionar la opción "importar" o "import".

1. Después pega la información en la barra de información.

1. Ajusta la url y las credenciales de tu cuenta.

2. ¡Listo! ✅