Revised:
1. Vad det är
WareRushAI REST-API låter andra program läsa ett företags data: produkter, lager per plats, beställningar, produkter med saknade data och publiceringsfel på marknadsplatser. Det är skrivskyddat i denna version och bygger på samma tjänster och behörighetskontroller som webbappen och MCP-kopplingen. Basadressen är https://app.warerushai.com/api/v1. API:et rullas ut gradvis: tills det har aktiverats för plattformen returnerar varje anrop 404 och inga nycklar kan skapas.
2. Skapa en API-nyckel
En ägare eller administratör öppnar Inställningar, sedan Integrationer, sedan API-nycklar, namnger nyckeln, väljer behörigheter (catalog.read, inventory.read, orders.read, account.read), giltighetstid och en gräns per minut, samt skapar den. Den fullständiga nyckeln börjar med wra_live_ och visas bara en gång. WareRushAI lagrar endast en envägs-hash och de första tecknen, så en förlorad nyckel kan inte återställas: skapa en ny. Du kan när som helst återkalla en nyckel eller rotera den: den nya nyckeln visas en gång och den gamla fortsätter fungera i 24 timmar.
3. Autentisering
Skicka nyckeln i Authorization-headern: Authorization: Bearer wra_live_... över HTTPS. Placera aldrig nyckeln i webbadressen; en begäran som gör det avvisas med key_in_url. Exempel: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". OAuth 2.1-åtkomsttoken från MCP-kopplingen godkänns också, med de behörigheter användaren har beviljat.
4. Slutpunkter
GET /me (nyckeln, dess gränser och dagens användning), GET /products (sökning och lista, med query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (lagerrader, sidnumrerade), GET /inventory/summary, GET /orders (med updated_since, status, source, limit, cursor), GET /missing-data och GET /marketplace-errors (med channel). Varje slutpunkt kräver matchande behörighet: catalog.read för produkter, saknade data och marknadsplatsfel, inventory.read för platser och lager, orders.read för beställningar. Endast GET stöds; andra metoder returnerar 405.
5. Paginering och polling
Listor returnerar data, next_cursor och has_more, med högst 50 objekt per sida (limit 1 till 50, standard 20). Skicka tillbaka next_cursor som cursor för att hämta nästa sida. För polling-triggers i Zapier, Make och n8n: anropa GET /orders?updated_since=2026-11-15T08:00:00Z och kom ihåg tidpunkten för din senaste lyckade avstämning: du får de beställningar som skapats eller ändrats sedan dess, med de senaste först.
6. Gränser och fel
Varje nyckel har en gräns per minut (standard 60, högst 600) och en valfri daglig gräns. Varje företag har också en daglig kvot baserad på abonnemang: som standard 1 000 anrop för Starter, 10 000 för Business och 100 000 för Pro. När en gräns nås svarar API:et med 429 och en Retry-After-header. Headerna X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit och X-Daily-Remaining visar vad som återstår. Fel visas alltid som {"error":{"code","message","request_id"}}; ange request_id när du kontaktar supporten. Vanliga koder: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited och daily_quota_exceeded (429).
7. OpenAPI-beskrivning
Den maskinläsbara OpenAPI 3.1-beskrivningen finns på https://app.warerushai.com/api/v1/openapi.json och kräver ingen nyckel. Importera den till Postman, Zapier, Make, n8n eller en AI-assistent för att få alla slutpunkter, parametrar och svarsstrukturer. Ändringar görs bakåtkompatibelt utan att bryta befintliga fält; versionen är /api/v1.
8. Säkerhet
Nycklar tillhör exakt ett företag och valideras vid varje anrop; en nyckel kan aldrig läsa ett annat företag, och den slutar fungera om administratören som skapade den lämnar företaget. Nycklar visas aldrig i loggar eller felmeddelanden, och anropsloggen visar endast sökväg, status och tidpunkt. Finansiella uppgifter såsom inköpspriser exponeras inte via detta API.
