Recursos

API REST pública de WareRushAI (solo lectura)

Consulta tus productos, stock, pedidos, datos faltantes y errores de marketplace desde Zapier, Make, n8n o tu propio código con una clave de API. Incluye especificación OpenAPI 3.1.

Revised:

1. Qué es

La API REST de WareRushAI permite a otros programas leer los datos de una empresa: productos, stock por ubicación, pedidos, productos con datos faltantes y errores de publicación en marketplaces. En esta versión es de solo lectura y se apoya en los mismos servicios y controles de permisos que la aplicación web y el conector MCP. La URL base es https://app.warerushai.com/api/v1. La API se está habilitando progresivamente: hasta que esté activada para la plataforma, cada llamada devolverá un error 404 y no se podrán crear claves.

2. Crear una clave de API

Un propietario o administrador abre Configuración, luego Integraciones, después Claves de API, asigna un nombre a la clave, selecciona los permisos (catalog.read, inventory.read, orders.read, account.read), una fecha de caducidad y un límite por minuto, y la crea. La clave completa comienza con wra_live_ y se muestra una sola vez. WareRushAI solo almacena un hash unidireccional y los primeros caracteres, por lo que una clave perdida no se puede recuperar: deberás crear una nueva. Puedes revocar una clave en cualquier momento o renovarla (rotación): la nueva clave se mostrará una vez y la antigua seguirá funcionando durante 24 horas.

3. Autenticación

Envía la clave en el encabezado Authorization: Authorization: Bearer wra_live_... a través de HTTPS. Nunca incluyas la clave en la URL; cualquier petición que lo haga será rechazada con key_in_url. Ejemplo: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". También se aceptan tokens de acceso OAuth 2.1 del conector MCP, con los permisos que el usuario haya aprobado.

4. Endpoints

GET /me (la clave, sus límites y el uso de hoy), GET /products (búsqueda y listado, con query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (líneas de stock, paginadas), GET /inventory/summary, GET /orders (con updated_since, status, source, limit, cursor), GET /missing-data y GET /marketplace-errors (con channel). Cada endpoint requiere el permiso correspondiente: catalog.read para productos, datos faltantes y errores de marketplace; inventory.read para ubicaciones e inventario; orders.read para pedidos. Solo se admite el método GET; otros métodos devuelven 405.

5. Paginación y sondeo (polling)

Los listados devuelven data, next_cursor y has_more, con un máximo de 50 elementos por página (limit de 1 a 50, valor por defecto 20). Envía next_cursor como cursor para obtener la página siguiente. Para disparadores de sondeo en Zapier, Make y n8n, llama a GET /orders?updated_since=2026-11-15T08:00:00Z y guarda la marca de tiempo de tu última comprobación correcta: obtendrás los pedidos creados o modificados desde entonces, ordenados del más reciente al más antiguo.

6. Límites y errores

Cada clave tiene un límite por minuto (60 por defecto, máximo 600) y un límite diario opcional. Cada empresa cuenta además con una cuota diaria según su plan: por defecto 1 000 llamadas para Starter, 10 000 para Business y 100 000 para Pro. Cuando se alcanza un límite, la API responde con un error 429 y un encabezado Retry-After. Los encabezados X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit y X-Daily-Remaining muestran la cuota restante. Los errores siempre tienen la estructura {"error":{"code","message","request_id"}}; indica el request_id cuando contactes con soporte. Códigos habituales: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited y daily_quota_exceeded (429).

7. Especificación OpenAPI

La especificación legible por máquina OpenAPI 3.1 está disponible en https://app.warerushai.com/api/v1/openapi.json y no requiere clave. Impórtala en Postman, Zapier, Make, n8n o en un asistente de IA para obtener todos los endpoints, parámetros y estructuras de respuesta. Las modificaciones se realizan sin alterar los campos existentes; la versión es /api/v1.

8. Seguridad

Las claves pertenecen exclusivamente a una empresa y se validan en cada llamada; una clave nunca puede consultar los datos de otra empresa, y dejará de funcionar si el administrador que la creó abandona la compañía. Las claves nunca aparecen en registros ni en mensajes de error, y el registro de llamadas solo muestra la ruta, el estado y la hora. Esta API no expone datos financieros como los precios de compra.