Integraciones
La API de integraciones de Fidely permite a sistemas externos (ERP, POS, e-commerce, etc.) interactuar con la plataforma de fidelizacion de clientes. A traves de esta API podras consultar saldos, registrar transacciones de compra y canjear puntos.
URL Base
https://fidely20backend.azurewebsites.net
Todos los endpoints estan bajo el prefijo /integrations/.
Autenticacion
La API utiliza el flujo OAuth2 Client Credentials. Necesitas un client_id y un client_secret que te proporcionara el equipo de Fidely.
Obtener un token de acceso
POST /integrations/auth/token
Content-Type: application/json
{
"client_id": "tu-client-id-uuid",
"client_secret": "tu-client-secret"
}
Respuesta exitosa (200):
{
"access_token": "a1b2c3d4e5f6...64_caracteres_hex",
"token_type": "Bearer",
"expires_in": 3600
}
| Campo | Descripcion |
|---|---|
access_token | Token que debes incluir en todas las llamadas posteriores |
token_type | Siempre "Bearer" |
expires_in | Duracion del token en segundos (por defecto 3600 = 60 minutos) |
Usar el token
Incluye el token en el header Authorization de cada request:
Authorization: Bearer a1b2c3d4e5f6...
Renovar el token
Cuando el token expire, simplemente solicita uno nuevo con el mismo endpoint. No hay refresh token; se genera uno nuevo cada vez.
Formato de respuesta
- Todas las respuestas son JSON
- Los errores devuelven
{ "error": "mensaje" }con el codigo HTTP apropiado
Codigos de error
| Codigo HTTP | Significado |
|---|---|
| 400 | Bad Request - Datos invalidos o faltantes |
| 401 | Unauthorized - Token invalido, expirado o ausente |
| 403 | Forbidden - Sin acceso a esta tienda o integrador deshabilitado |
| 404 | Not Found - Cliente no encontrado |
| 500 | Internal Server Error - Error del servidor |
Coleccion Postman
Podes importar la coleccion de Postman para probar la API rapidamente:
Despues de importarla, configura las variables de la coleccion:
| Variable | Descripcion |
|---|---|
base_url | URL base de la API (https://fidely20backend.azurewebsites.net) |
client_id | Tu Client ID |
client_secret | Tu Client Secret |
store_id | ID de tu tienda |
dni | DNI de un cliente para pruebas |
La coleccion guarda automaticamente el access_token al ejecutar el request de autenticacion.