Errores y paginación

Códigos de estado

La API usa códigos HTTP estándar:

Código	Significado
`200`	Éxito.
`400`	Petición inválida (falta un campo, formato incorrecto).
`401`	Sin autenticación o API key inválida.
`403`	La key no tiene permiso: scope faltante, IP no autorizada o plan sin acceso a la API.
`404`	Recurso no encontrado.
`429`	Superaste un límite de solicitudes (por minuto, diario o mensual).
`500`	Error interno del servidor.

Formato de error

Los errores devuelven un cuerpo JSON con un mensaje descriptivo:

{
  "statusCode": 400,
  "statusMessage": "Se requiere email o número de teléfono"
}

Los mensajes están en español.

Paginación

Los endpoints que devuelven listas (clientes, ventas, recompensas) aceptan los parámetros de query:

Parámetro	Tipo	Descripción
`page`	número	Página a devolver. Por defecto `1`.
`limit`	número	Elementos por página. Por defecto `20`, máximo `100`.
`search`	texto	Filtro de búsqueda (según el endpoint).

La respuesta tiene esta forma:

{
  "data": [ /* ... elementos ... */ ],
  "meta": {
    "currentPage": 1,
    "total": 342,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}