Frissítve:
1. Mi ez az API
A WareRushAI REST API-ja más programoknak engedi olvasni egy cég adatait: termékeket, telephelyenkénti készletet, rendeléseket, hiányos adatú termékeket és piactéri feltöltési hibákat. Ebben a verzióban csak olvasni lehet, és ugyanazokra a szolgáltatásokra és jogosultság-ellenőrzésekre épül, mint a webalkalmazás és az MCP-csatoló. Alapcíme: https://app.warerushai.com/api/v1. Az API-t fokozatosan nyitjuk meg: amíg a platformon nincs bekapcsolva, minden hívás 404-et ad, és kulcs sem hozható létre.
2. API-kulcs létrehozása
Tulajdonos vagy adminisztrátor a Beállítások, Integrációk, API-kulcsok oldalon nevet ad a kulcsnak, kiválasztja a jogosultságokat (catalog.read, inventory.read, orders.read, account.read), a lejáratot és a percenkénti korlátot, majd létrehozza. A teljes kulcs wra_live_ előtaggal kezdődik, és csak egyszer látszik. A WareRushAI csak egyirányú hash-t és az első karaktereket tárolja, ezért az elveszett kulcs nem állítható vissza: hozz létre újat. A kulcsot bármikor visszavonhatod, vagy elforgathatod: az új kulcs egyszer látszik, a régi még 24 órán át működik.
3. Hitelesítés
A kulcsot az Authorization fejlécben küldd HTTPS-en: Authorization: Bearer wra_live_... A kulcs soha nem lehet a webcímben; az ilyen kérést a rendszer key_in_url hibával elutasítja. Példa: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". Az MCP-csatoló OAuth 2.1 hozzáférési tokenjei is elfogadottak, a felhasználó által jóváhagyott jogosultságokkal.
4. Végpontok
GET /me (a kulcs, korlátai és a mai használat), GET /products (keresés és lista: query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (készletsorok, lapozva), GET /inventory/summary, GET /orders (updated_since, status, source, limit, cursor), GET /missing-data és GET /marketplace-errors (channel). Mindegyikhez a megfelelő jogosultság kell: a termékekhez, hiányos adatokhoz és piactéri hibákhoz catalog.read, a telephelyekhez és készlethez inventory.read, a rendelésekhez orders.read. Csak a GET működik, más módszerre 405 a válasz.
5. Lapozás és lekérdezés
A listák data, next_cursor és has_more mezőt adnak, oldalanként legfeljebb 50 elemmel (limit 1 és 50 között, alapérték 20). A next_cursor értékét cursor paraméterként küldd vissza a következő oldalhoz. A Zapier, a Make és az n8n lekérdezéses eseményindítóihoz hívd a GET /orders?updated_since=2026-11-15T08:00:00Z végpontot, és jegyezd meg az utolsó sikeres lekérdezés idejét: az azóta létrejött vagy módosult rendeléseket kapod, a legfrissebbel kezdve.
6. Korlátok és hibák
Minden kulcsnak van percenkénti korlátja (alapérték 60, legfeljebb 600) és opcionális napi korlátja. Minden cégnek van csomaghoz kötött napi kerete is: alapból Starter 1 000, Business 10 000, Pro 100 000 hívás naponta. Ha egy korlátot elérsz, az API 429-et ad Retry-After fejléccel. Az X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit és X-Daily-Remaining fejlécek mutatják a hátralevőt. A hibák alakja mindig {"error":{"code","message","request_id"}}; az ügyfélszolgálatnak add meg a request_id értékét. Gyakori kódok: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited és daily_quota_exceeded (429).
7. OpenAPI-leírás
A gépileg olvasható OpenAPI 3.1 leírás a https://app.warerushai.com/api/v1/openapi.json címen érhető el, kulcs nélkül. Importáld Postmanbe, Zapierbe, Make-be, n8n-be vagy egy AI-asszisztensbe, így megkapod az összes végpontot, paramétert és válaszszerkezetet. A változtatások nem törik a meglévő mezőket; a verzió /api/v1.
8. Biztonság
A kulcs pontosan egy céghez tartozik, és minden híváskor ellenőrzött; soha nem olvashat másik céget, és megszűnik működni, ha a létrehozó adminisztrátor kilép a cégből. A kulcs nem jelenik meg naplóban és hibaüzenetben, a hívásnapló csak az útvonalat, az állapotot és az időt mutatja. Pénzügyi adatot, például beszerzési árat az API nem ad ki.
