Apariencia
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/jsonEl 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.
