Kezdje el most

Fejlesztőknek

Fejlesztői API-k: egy webáruház rendszer, amelyet a kódja és az AI-ja is ért

Admin GraphQL, Storefront API, REST és webhookok. JSON kimenetű CLI minden parancsra. Dev MCP, amellyel az AI-ügynöke beolvassa a sémát, és futtatás előtt ellenőrzi a lekérdezést. Minden dokumentálva van a cloudcart.dev oldalon.

Hozza létre webáruházát Fejlesztői portál

GraphQL és REST · CLI és Dev MCP · Headless vásárlói felületek

AI Toolkit a GitHubon

Három API

Minden feladatra egy API

REST a külső integrációkhoz, Admin GraphQL az admin felülethez és az ügynökökhöz, Storefront GraphQL a vásárlói felülethez. Mindhárom mögött ugyanaz a webáruház.

/api/v2

JSON-API v2 · REST

  • Külső integrációk: ERP, Make, Zapier, szkriptek
  • Webáruházanként egy API-kulcs
  • JSON:API 1.0, kérésenként egy erőforrás
GET /api/v2/products?filter[sku]=RS-30 X-CloudCart-ApiKey: ••• Accept: application/vnd.api+json
Dokumentáció
/api/gql

Admin GraphQL

  • Önleíró séma introspekcióval
  • Personal Access Token, minden mutáció naplózva
  • Ezt használja a CLI és az AI-ügynökök
POST /api/gql { products(first: 1, sku: "RS-30") { edges { node { id name pricing { from } } } } }
Dokumentáció
/api/sf

Storefront GraphQL

  • Headless vásárlói felületek: Next.js, Nuxt, SvelteKit, Remix, Astro
  • Hatókörrel rendelkező Storefront token + vásárlói JWT
  • Kérések a vásárló böngészőjéből
POST /api/sf X-Storefront-Access-Token: ••• { product(handle: "serum-s-rozovo-maslo") { title priceRange { minVariantPrice { formatted } } } }
Dokumentáció
01Valós idejű webhookok minden rendelés-, termék- vagy vásárlóváltozásnál. Dokumentáció →
02Tokenek: API-kulcsok az integrációkhoz, Personal Access Tokenek a CLI-hez és a GraphQL-hez, hatókörrel rendelkező Storefront tokenek a vásárlói felületekhez.

AI asszisztens + Nitrogen

Csatlakozás egy perc alatt

Egyetlen mondattal összekapcsolja AI asszisztensét a CloudCarttal. Ezután elmondja, milyen kirakatot szeretne, az asszisztens pedig megírja Nitrogennel, és GitHubon keresztül élesíti.

A mondat az AI asszisztensnek
Fetch and follow the instructions at https://raw.githubusercontent.com/cloudcart/ai-toolkit/main/prompt.md to set up my AI agent for CloudCart

Az asszisztens megkérdezi, milyen nyelven dolgozzanak, és azon válaszol Önnek.

  1. Nyissa meg az AI asszisztenst

    Claude Code, ChatGPT Codex, Cursor, VS Code vagy Gemini CLI.

  2. Illessze be a mondatot

    Az asszisztens mindent magától beállít.

  3. Adjon hozzáférési kulcsot

    Beállítások → „PAT Tokens” → új token. Kész, írhat.

A PAT token: az asszisztens kulcsa a webáruházhoz

Csak annyi jogosultság, amennyi kell

Létrehozáskor választhat: csak olvasás, teljes hozzáférés vagy erőforrásonkénti jogosultságok. A token a CloudCart CLI-vel és az Admin GraphQL-lel működik.

Lejárat és IP-címek

Megadhatja, meddig érvényes a token, és legfeljebb 20 IP-címet vagy hálózatot, ahonnan elfogadja.

Az Ön irányítása alatt

Tokent csak a webáruház tulajdonosa hozhat létre. Az értéke egyszer jelenik meg. A tokent egy kattintással kikapcsolja vagy törli, és a hozzáférés azonnal megszűnik.

Hivatalos útmutató: github.com/cloudcart/ai-toolkit · Nitrogen: cloudcart.dev/docs/nitrogen

AI Toolkit és CLI

Együttműködik az AI-ügynökével

$ cloudcart app execute --query 'mutation { productsBulkAdjustPrice(selector: { categoryId: 12 }, change: { op: PERCENT_DELTA, value: 5 }) { jobId queuedCount } }' --json

A CloudCart CLI parancssori felület a webáruházához, az AI-ügynököket szem előtt tartva. Beépített, és azonnal működik. Minden parancs JSON-nal és egyértelmű kilépési kóddal válaszol: sikerült-e, és ha nem, miért. Így egy szkript vagy egy AI-ügynök ugyanolyan könnyen használja, mint egy mérnök.

JSON kimenetés kilépési kódok minden parancsnál
Szkriptelhetőügynökökből és CI-ból
Képfelismerésa parancssorban

Megtekintés a GitHubon

Új integrációt készít

Leírja, a Claude pedig legenerálja a GraphQL-műveleteket, validálja őket, és összeköti a logikát

› „Szinkronizáld óránként a készletet a WMS-ünkből”

Lekérdezéseket ír és tesztel

A Claude beolvassa a sémát, megírja a lekérdezést, és futtatás előtt ellenőrzi a Dev MCP-n keresztül

› „Melyik termékeknek nincs képe?”

Nitrogen komponensvázlatok

Komponens a vásárlói felülethez a Storefront API-ra építve, az Ön keretrendszeréhez

› „Termékkártya termékváltozat-választóval”

A Dev MCP ugyanezt adja a Claude Code-nak, a ChatGPT Codexnek, a Cursornak, a VS Code-nak és a Gemini CLI-nek: beolvassák a sémát, és futtatás előtt ellenőrzik a lekérdezést.

Nitrogen - a mi headless technológiánk

A vásárlói felületet React Routerrel és Tailwinddel írja

A Nitrogen React Routerre és Tailwindre épül, a CloudCart starterével. A Storefront API más keretrendszerrel is használható, de a Nova tárhely a Nitrogenhez készült. A termékkatalógus, a rendelések, a fizetések és a készlet a CloudCartban marad.

localhost:5173dev

Három változat · válasszon egyet

Az Ön nyelvi modelljeÍrja le a változtatást…

A webaruhazad.hu minta-webáruház főoldala. A fejlesztő azt írja a nyelvi modelljének: „Készíts három őszi változatot a főoldalból”, és három változatot kap: meleg tónusok, sötét banner és teljes kép. A kiválasztott lesz a főoldal - a változtatás a vásárlói felület kódjában történik.

Az API-k

  • Storefront GraphQL nyilvános és privát tokennel
  • Customer Account API: belépés jelszó nélkül, 6 jegyű kóddal
  • A jelenlegi sablon és a Nitrogen egyszerre működik, különböző domaineken

Deploy és Nova

  • cloudcart nitrogen deploy a CLI-ből vagy az Ön CI-jából
  • Vagy GitHub App: deploy minden pushnál
  • Nova: Cloudflare Workers, <handle>.cloudcart.dev, csak production, környezeti változók

Amit Ön intéz

  • robots.txt és sitemap.xml
  • A 301-es átirányítások
  • A kapcsolatfelvételi űrlap és a cookie-hozzájárulás

Ezek nem jönnek automatikusan a Nitrogen domainen - az alkalmazása kezeli őket. A dokumentáció leírja, hogyan.

Nitrogen dokumentáció

Források

Közvetlen linkek

Limitek és szabályok

Előre megmondjuk, nem az első 429 után

A limitek nyilvánosak, hogy már a megírása előtt megtervezhesse az integrációt.

Kérések percenként, csomagonként

A limit a JSON-API v2-re (/api/v2) vonatkozik. Minden válasz tartalmazza az X-RateLimit-Limit, az X-RateLimit-Remaining és a Retry-After fejlécet; túllépéskor 429 JSON törzzsel. A webáruház összes kulcsa egy közös kereten osztozik. A limit a webáruház fő domainjére érvényes.

Webhooks

A fogadó végpontnak 2xx-szel kell válaszolnia, és bírnia kell a csúcsokat - egy tömeges katalógusmódosítás sok eseményt küld egyszerre. Az a cím, amely folyamatosan hibát ad vissza, automatikusan kikapcsol.

Egy webhook kézbesítése legfeljebb 30 másodpercig vár.

Időkorlátok

30 másodperc kérésenként a JSON-API v2 és az admin felület felé. A nagy olvasást, amely ebbe nem fér bele, lapozással kell végezni, nem kap több időt.

A visszaélés elleni védelmeket (botok, flood) nem tesszük közzé; az a kliens, amely működésbe hozza őket, 429-et vagy 403-at kap.

Beszéljen a mérnökeinkkel

Ön hozza a feladatot, mi megmutatjuk, melyik API oldja meg, és hol van dokumentálva.

Beszéljen a CloudCart tanácsadójával