Generar Token API

Genera un token de acceso de tipo API Key para realizar peticiones programáticas a la API de Guarani. Este token permite acceso permanente sin necesidad de autenticación por usuario, ideal para integraciones y automatizaciones.

Entorno

URL base: https://api.guarani.app

Endpoint

POST /auth/api/token

Autenticación requerida

Este endpoint requiere que estés autenticado con un token de sesión de empresa válido.

Ejemplo de solicitud

curl -X POST "https://api.guarani.app/auth/api/token" \
  -H "Content-Type: application/json" \
  -H "x-session: <token_sesion_empresa>" \
  -d '{
    "nombre": "Token para producción",
    "ips": ["192.168.1.100", "10.0.0.5"]
  }' | jq

Encabezados de la solicitud

Encabezado	Valor	Requerido	Descripción
`Content-Type`	`application/json`	Sí	Indica que los datos se envían en formato JSON.
`x-session`	`<token>`	Sí	Token de sesión de empresa obtenido después del login y selección de empresa

Descripción de campos

Parámetro	Tipo	Requerido	Descripción
`nombre`	`string`	Sí	Nombre identificativo para el token API. Útil para reconocer el propósito del token (ej: “Producción”)
`ips`	`array`	Sí	Lista de direcciones IP permitidas para usar este token. Cada IP debe ser un string válido

Ejemplo de respuesta

{
  "success": true,
  "codigo": 200,
  "message": "Operación realizada correctamente.",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbXByZXNhSWQiOiIxMjM0NSIsInVzdWFyaW9JZCI6IjY3ODkwIiwiaWF0IjoxNjk5ODg4ODg4fQ.xxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Uso del token generado

Una vez generado el token API, puedes usarlo para autenticar tus peticiones usando el header x-api-key:

curl -X GET "https://api.guarani.app/empresas" \
  -H "x-api-key: <tu_token_api>"

Recursos adicionales

Si necesitas revocar un token, contacta a soporte
Consulta la sección de errores para más información sobre códigos de error.