Autenticación

Este endpoint permite obtener un token de acceso para autenticar solicitudes a la API mediante las credenciales del sistema.

• Propósito: Autenticar aplicaciones y generar un token de acceso válido mediante el flujo Client Credentials de OAuth 2.0.
• Duración del token: 1 hora. Tras este periodo, será necesario renovarlo solicitando un nuevo token.
• Credenciales: Para obtener credenciales (client_id y client_secret), contacta al administrador de la API.

Nota: El token es obligatorio para realizar cualquier solicitud a los endpoints protegidos de la API.

Método: POST

Endpoint

Sandbox

https://api-sandbox.lumendte.com/oauth/token

Producción

https://api.lumendte.com/oauth/token

---

Parámetros del Cuerpo de Solicitud

El cuerpo de la solicitud debe enviarse como x-www-form-urlencoded e incluir los siguientes parámetros obligatorios:

Parámetros
grant_type: client_credentials — Tipo de autenticación. Es el único valor soportado.
client_id: tu client id — Identificador único del cliente.
client_secret: tu client secret — Secreto asociado al cliente.

Ejemplo de Solicitud

A continuación, se muestra un ejemplo de cómo enviar una solicitud al endpoint:

cURL

curl -X POST https://api-sandbox.lumendte.com/oauth/token \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=tu client id" \
  -d "client_secret=tu client secret"

Node.js

const axios = require('axios');
const qs = require('qs');

const data = qs.stringify({
  grant_type: 'client_credentials',
  client_id: 'tu client id',
  client_secret: 'tu client secret',
});

const config = {
  method: 'post',
  url: 'https://api-sandbox.lumendte.com/oauth/token',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  data,
};

axios(config)
  .then((response) => {
    console.log('Token de acceso:', response.data.access_token);
    console.log('Expira en (segundos):', response.data.expires_in);
  })
  .catch((error) => {
    console.error(
      'Error en la solicitud:',
      error.response ? error.response.data : error.message,
    );
  });

Python

import requests

response = requests.post(
    'https://api-sandbox.lumendte.com/oauth/token',
    headers={
        'Accept': 'application/json',
        'Content-Type': 'application/x-www-form-urlencoded',
    },
    data={
        'grant_type': 'client_credentials',
        'client_id': 'tu client id',
        'client_secret': 'tu client secret',
    },
)

if response.ok:
    data = response.json()
    print('Token de acceso:', data['access_token'])
    print('Expira en (segundos):', data['expires_in'])
else:
    print('Error en la solicitud:', response.text)

Response Success

Status: 200 OK

{
  "access_token": "tu access token",
  "token_type": "Bearer",
  "expires_in": 3600
}