API v1

Scale IA API

Conecta tu POS, sistema de cobros, o cualquier app externa con tu negocio en Scale IA.

Autenticacion

Todas las peticiones requieren un API key en el header Authorization. Genera tu key desde Ajustes > API en tu panel de administracion.

curl -H "Authorization: Bearer sk_live_tu_api_key_aqui" \
  https://scalesystema.app/api/v1/members

Importante: Tu API key solo se muestra una vez al crearla. Guardala en un lugar seguro. Si la pierdes, revocala y crea una nueva.

Base URL

https://scalesystema.app/api/v1

Todas las respuestas son JSON. Usa Content-Type: application/json para POST/PATCH.

Rate Limits

Limite

60 req/min

Por

API Key

Si excedes el limite, recibiras un 429 Too Many Requests. Espera 60 segundos e intenta de nuevo.

Formato de respuesta

Exito

{
  "success": true,
  "data": [...],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 120
  }
}

Error

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}

Codigos de error

400Bad RequestJSON invalido o campos faltantes

401UnauthorizedAPI key invalida o faltante

403ForbiddenLa key no tiene permisos para esta operacion

404Not FoundRecurso no encontrado

429Too Many RequestsRate limit excedido

500Internal ErrorError del servidor

Endpoints

Miembros

Pagos

Productos / Servicios

Reservas / Citas

Ejemplo completo

Un POS externo registra un pago en Scale IA:

# 1. Buscar miembro por telefono
curl -H "Authorization: Bearer sk_live_xxx" \
  "https://scalesystema.app/api/v1/members?search=+50212345678"

# 2. Registrar el pago
curl -X POST \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "member_id": "uuid-del-paso-1",
    "amount": 75.00,
    "currency": "USD",
    "description": "Pago desde POS Square"
  }' \
  https://scalesystema.app/api/v1/payments