Skip to content

Autenticación ​

El API usa tokens JWT. Primero pides un token con el usuario y la contraseña de API del negocio; después lo envías en el encabezado Authorization de cada solicitud.

1. Pedir el token ​

http
POST {{host}}api/Invoice/create_token_authenticator
Content-Type: application/json

{
  "userName": "usuario@example.com",
  "userPassword": "<contraseña de API>"
}

Respuesta:

json
{
  "success": true,
  "message": "Token de Acceso",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

Detalle de campos y errores: Solicitar token.

2. Usar el token ​

Envía el token en cada solicitud con el esquema Bearer:

http
POST {{host}}api/Invoice/add_list_invoice
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Content-Type: application/json

El token identifica al negocio emisor: todos los documentos que crees con él se emiten a nombre de ese negocio, con sus números de control y su firma.

Vigencia ​

El token vence a la hora de emitido. Cuando vence, el API responde 401 y debes pedir uno nuevo. Recomendación: guarda el token y pide otro solo cuando recibas un 401, en vez de pedir uno por cada solicitud.

Buenas prácticas ​

  • Guarda el usuario y la contraseña de API en un lugar seguro del servidor (variables de entorno o un gestor de secretos), nunca en el código del cliente ni en el navegador.
  • No compartas el token: quien lo tenga puede emitir documentos a nombre del negocio.
  • Usa siempre HTTPS.

Errores de autenticación: ver Errores.

API de Facturación · CG Imprenta Digital