Obtener token

Genera un token de acceso temporal para autenticar las solicitudes en los endpoints de la API de Trazo. Este token es requerido para interactuar con los recursos protegidos y su validez está determinada por el parámetro expires_in.

Endpoint

GET {{base_url}}/token

Headers

Nombre	Tipo	Descripción
Authorization *	String	Bearer {{auth_key}}

Asegúrate de incluir la palabra clave Bearer seguida de un espacio antes de tu llave de autenticación auth_key.

Response

200 OK

{
    "access_token": "das87...82fdh",
    "expires_in": 3600
}

401 Unauthorized

{
    "status": "unauthorized",
    "code": "Q001",
    "error": "La autorización no se encuentra en el formato correcto o no está habilitada en el sistema de Trazo"
}

Atributos de la respuesta

• access_token (string): Token de portador (Bearer token) que se utilizará para autenticar las siguientes solicitudes.

• expires_in (integer): Tiempo de vigencia del token expresado en segundos (ej. 3600 segundos equivalente a 1 hora).

---

Ejemplo

cURL

curl --request GET '{{base_url}}/token' \
  --header 'Authorization: Bearer {{auth_key}}'

Node.js - Axios

const axios = require('axios');

const config = {
  method: 'get',
  url: '{{base_url}}/token',
  headers: { 
    'Authorization': 'Bearer {{auth_key}}'
  }
};

axios(config)
  .then((response) => {
    // Formatea el JSON para que se imprima ordenado en la consola
    console.log(JSON.stringify(response.data, null, 2));
  })
  .catch((error) => {
    console.error('Error en la autenticación:', error.response ? error.response.data : error.message);
  });

Python - Requests

import requests

url = "{{base_url}}/token"
headers = { 
    "Authorization": "Bearer {{auth_key}}"
}

try:
    # Usamos .get() directo en lugar de .request("GET")
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    
    # Parseamos la respuesta directamente a un diccionario de Python
    token_data = response.json()
    print(token_data)

except requests.exceptions.RequestException as error:
    print(f"Error al obtener el token: {error}")

Autenticación en otros Endpoints

Una vez obtenido el access_token, este debe ser enviado en el encabezado x-auth-token para consumir cualquier otro servicio protegido de Trazo.

Ejemplo de uso posterior (cURL)

curl --request POST '{{base_url}}/transaction' \
  --header 'x-auth-token: {{access_token}}' \
  --header 'Content-Type: application/json'

Puedes revisar una implementación completa en la sección Generar Cobro.