Ressources

API REST publique WareRushAI (lecture seule)

Lisez vos produits, stocks, commandes, données manquantes et erreurs de marketplace depuis Zapier, Make, n8n ou votre propre code à l'aide d'une clé API. Spécification OpenAPI 3.1 incluse.

Revised:

1. Présentation

L'API REST WareRushAI permet à d'autres applications de lire les données d'une entreprise : produits, stocks par emplacement, commandes, produits avec données manquantes et erreurs de publication sur les marketplaces. Cette version est en lecture seule et repose sur les mêmes services et vérifications de permissions que l'application web et le connecteur MCP. L'adresse de base est https://app.warerushai.com/api/v1. L'API est déployée progressivement : tant qu'elle n'est pas activée sur la plateforme, chaque appel renvoie une erreur 404 et aucune clé ne peut être créée.

2. Créer une clé API

Un propriétaire ou un administrateur ouvre Paramètres, puis Intégrations, puis Clés API, nomme la clé, sélectionne les autorisations (catalog.read, inventory.read, orders.read, account.read), une date d'expiration ainsi qu'une limite par minute, puis la génère. La clé complète commence par wra_live_ et ne s'affiche qu'une seule fois. WareRushAI n'enregistre qu'un hachage à sens unique et les premiers caractères ; une clé perdue ne peut donc pas être récupérée : créez-en une nouvelle. Vous pouvez révoquer une clé à tout moment ou la renouveler (rotation) : la nouvelle clé s'affiche une fois et l'ancienne reste active pendant 24 heures.

3. S'authentifier

Transmettez la clé dans l'en-tête Authorization : Authorization: Bearer wra_live_... via HTTPS. N'incluez jamais la clé dans l'URL ; toute requête qui le fait est rejetée avec l'erreur key_in_url. Exemple : curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". Les jetons d'accès OAuth 2.1 du connecteur MCP sont également acceptés, avec les autorisations approuvées par l'utilisateur.

4. Endpoints

GET /me (la clé, ses limites et l'utilisation du jour), GET /products (recherche et liste, avec query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (lignes de stock, paginées), GET /inventory/summary, GET /orders (avec updated_since, status, source, limit, cursor), GET /missing-data et GET /marketplace-errors (avec channel). Chaque endpoint nécessite l'autorisation correspondante : catalog.read pour les produits, les données manquantes et les erreurs de marketplace, inventory.read pour les emplacements et les stocks, orders.read pour les commandes. Seule la méthode GET est prise en charge ; les autres méthodes renvoient un code 405.

5. Pagination et scrutation (polling)

Les listes renvoient data, next_cursor et has_more, avec un maximum de 50 éléments par page (limit de 1 à 50, valeur par défaut : 20). Transmettez next_cursor dans le paramètre cursor pour obtenir la page suivante. Pour les déclencheurs de scrutation sur Zapier, Make et n8n, appelez GET /orders?updated_since=2026-11-15T08:00:00Z et conservez l'heure de votre dernière interrogation réussie : vous obtiendrez les commandes créées ou modifiées depuis lors, de la plus récente à la plus ancienne.

6. Limites et erreurs

Chaque clé a une limite par minute (60 par défaut, 600 au maximum) et une limite quotidienne facultative. Chaque entreprise dispose également d'un quota quotidien selon son forfait : par défaut 1 000 appels pour Starter, 10 000 pour Business et 100 000 pour Pro. Lorsqu'une limite est atteinte, l'API répond 429 avec un en-tête Retry-After. Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit et X-Daily-Remaining indiquent le quota restant. Les erreurs se présentent toujours sous la forme {"error":{"code","message","request_id"}} ; indiquez le request_id lorsque vous contactez le support. Codes courants : invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited et daily_quota_exceeded (429).

7. Spécification OpenAPI

La spécification OpenAPI 3.1 lisible par machine est accessible sur https://app.warerushai.com/api/v1/openapi.json et ne requiert aucune clé. Importez-la dans Postman, Zapier, Make, n8n ou un assistant IA pour obtenir l'ensemble des endpoints, des paramètres et des formats de réponse. Les évolutions sont apportées sans altérer les champs existants ; la version est /api/v1.

8. Sécurité

Les clés appartiennent exclusivement à une seule entreprise et sont vérifiées à chaque appel ; une clé ne peut jamais lire les données d'une autre entreprise, et elle cesse de fonctionner si l'administrateur qui l'a créée quitte l'entreprise. Les clés n'apparaissent jamais dans les journaux ni dans les messages d'erreur, et le journal des appels n'affiche que le chemin, le statut et l'horodatage. Les données financières telles que les prix d'achat ne sont pas exposées par cette API.