v1.0 Stable

LineFy API

API REST para la gestión automatizada de puntos de fidelidad y recompensas de usuarios.

Introducción

Bienvenido a la referencia de Loyalty Points API. Este servicio permite agregar puntos a las cuentas de usuario basándose en reglas de negocio predefinidas.

Base URL

https://api.linefy.app

Estado

Sistemas operativos • v1.0 Stable

Autenticación

Esta API utiliza el esquema estándar Bearer Token. Debes incluir tu clave de API en el encabezado de cada solicitud.

Header

Authorization: Bearer YOUR_API_KEY

Límites (Rate Limit)

Límite: 10 solicitudes por minuto

Si se excede este límite, recibirás un error 429 Too Many Requests. Si no se envía el token, el límite se aplica por dirección IP.

Endpoints

POST/v1/add-points

Agregar Puntos

Agrega puntos a un usuario basado en las reglas activas de la tienda asociada a tu API Key. Es idempotente si se envía el ID de transacción externa.

cURL

bash

curl -X POST \
  "https://api.linefy.app/v1/add-points" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "username": "messi",
    "monto": 120.5,
    "external_txn_id": "ORDER-12345"
  }'

JavaScript (Fetch)

javascript

const response = await fetch("https://api.linefy.app/v1/add-points", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    username: "messi",
    monto: 120.5,
    external_txn_id: "ORDER-12345"
  }),
});

const data = await response.json();

Códigos de Error

HTTP	Código API	Descripción
400	ERR_VALIDATION	Datos enviados no válidos o formato incorrecto.
400	ERR_NO_APPLICABLE_RULE	No hay reglas activas para el monto proporcionado.
401	ERR_API_KEY_MISSING	Falta el token Bearer en el header.
401	ERR_API_KEY_INVALID	El token proporcionado no es válido.
404	ERR_USER_NOT_FOUND	El usuario especificado no existe en el sistema.
409	ERR_DUPLICATE_TRANSACTION	El external_txn_id ya fue procesado anteriormente.
429	TOO_MANY_REQUESTS	Has excedido el límite de 10 peticiones/min.
500	ERR_SERVER	Error interno del servidor.