Autenticación

La API de E3 Stores utiliza un sistema de autenticación basado en hash tokens para garantizar la seguridad de todas las operaciones.

Flujo de autenticación

1. Enviar credenciales al endpoint de autenticación
2. Recibir hash token en la respuesta
3. Incluir hash en todas las peticiones subsiguientes
4. Renovar token cuando sea necesario

Obtener hash de autenticación

Endpoint

GET /Api/Auth/

Parámetros requeridos

Parámetro	Tipo	Descripción	Ejemplo
username	string	Nombre de usuario	TestApi
password	string	Contraseña del usuario	TestApi1357

Ejemplo de petición

curl -X GET \
  "https://demo.e3stores.cloud/Api/Auth/?username=TestApi&password=TestApi1357" \
  -H "Content-Type: application/json"

Ejemplo de respuesta exitosa

{
  "status": "success",
  "message": "Authentication successful",
  "data": "5de3928b-6018-4b0c-9ebd-bc2c3e18f708",
  "site": 3
}

Usar el hash en peticiones

Una vez obtenido el hash, debes incluirlo como parámetro de consulta en todas las peticiones posteriores.

Ejemplo con inventario

curl -X GET \
  "https://demo.e3stores.cloud/api/inventory?hash=5de3928b-6018-4b0c-9ebd-bc2c3e18f708" \
  -H "Content-Type: application/json"

Seguridad y mejores prácticas

Almacenamiento seguro del hash

• NUNCA hardcodees el hash en tu código
• Usa variables de entorno para credenciales
• Almacena el hash de forma segura

Renovación de tokens

• Los tokens pueden expirar
• Implementa lógica de renovación automática
• Maneja errores 401 re-autenticando