# Fejlesztői API-k: GraphQL, REST, CLI és MCP | CloudCart

Admin GraphQL, Storefront API, REST és webhookok, JSON kimenetű CLI és Dev MCP az AI-ügynököknek. A limitek nyilvánosak, a dokumentáció a cloudcart.dev oldalon érhető el.

Forrás: https://cloudcart.com/hu/developers · CloudCart

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](https://my.cloudcart.com/hu/register) [Fejlesztői portál](https://cloudcart.dev/)

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

[AI Toolkit a GitHubon](https://github.com/cloudcart/ai-toolkit)

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
200 OK · 41 ms [Dokumentáció](https://cloudcart.dev/docs/rest-api)

/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 } } } } }
200 OK · 38 ms [Dokumentáció](https://cloudcart.dev/docs/admin-api)

/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 } } } }
200 OK · 23 ms [Dokumentáció](https://cloudcart.dev/docs/storefront-api)

01Valós idejű webhookok minden rendelés-, termék- vagy vásárlóváltozásnál. [Dokumentáció →](https://cloudcart.dev/docs/webhooks)
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 CloudCartAz asszisztens megkérdezi, milyen nyelven dolgozzanak, és azon válaszol Önnek.

### Nyissa meg az AI asszisztenst
Claude Code, ChatGPT Codex, Cursor, VS Code vagy Gemini CLI.

### Illessze be a mondatot
Az asszisztens mindent magától beállít.

### 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 kellLé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ímekMegadhatja, meddig érvényes a token, és legfeljebb 20 IP-címet vagy hálózatot, ahonnan elfogadja.

Az Ön irányítása alattTokent 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](https://github.com/cloudcart/ai-toolkit) · Nitrogen: [cloudcart.dev/docs/nitrogen](https://cloudcart.dev/docs/nitrogen)

AI Toolkit és CLI

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

Az Ön AI-ügynökeClaude · Cursor …

Emeld meg 5 %-kal az összes szérum árát
Megkeresi a műveletet a sémábansemantic_search → productsBulkAdjustPrice
Megkeresi a „Szérumok” kategóriátcloudcart app execute → categoryId 12
Futtatás előtt ellenőrzivalidate_graphql_codeblocks → ✓ SUCCESS
Lefuttatja a CloudCart CLI-velcloudcart app execute → exit 0
Megvárja, amíg a webáruház végezbulkOperationStatus → COMPLETED · 12
Kész: a „Szérumok” kategóriában 12 termék ára 5%-kal magasabb.

CloudCart CLIapp execute
productsBulkAdjustPricecategoryId: 12PERCENT_DELTA · 5--json

exit 0 · queuedCount 12

Admin · Termékek

Termékek › Rózsaolajos szérum

Rózsaolajos szérum

Részletek

NévRózsaolajos szérum
Kategória Szérumok
SKURS-30
Ár42,00 €42,00 €+5 %

$ 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](https://github.com/cloudcart/ai-toolkit)

### Ú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”› „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?”› „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”› „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

yourstore .bg

Új kollekció Őszi kollekció

Kozmetikumok bolgár rózsábólŐszi ápolás rózsaolajjal
Szérumok és krémek rózsaolajjal.Meleg textúrák a hűvös napokra.

Fedezze felA szérumokhoz

TermékekÖsszes

Hialuronsavas szérum38,00 €
Éjszakai szérum54,00 €
Szérum és krém szett68,00 €
Rózsaolajos szérum42,00 €

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, .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ó](https://cloudcart.dev/docs/nitrogen)

Források

## Közvetlen linkek

dokumentáció

[Admin GraphQL cloudcart.dev/docs/admin-api](https://cloudcart.dev/docs/admin-api)
[Storefront API cloudcart.dev/docs/storefront-api](https://cloudcart.dev/docs/storefront-api)
[REST API cloudcart.dev/docs/rest-api](https://cloudcart.dev/docs/rest-api)
[REST referencia developers.cloudcart.com/2.0/overview](https://developers.cloudcart.com/2.0/overview)
[Webhooks cloudcart.dev/docs/webhooks](https://cloudcart.dev/docs/webhooks)
[Nitrogen cloudcart.dev/docs/nitrogen](https://cloudcart.dev/docs/nitrogen)

[cloudcart.dev · portál cloudcart.dev](https://cloudcart.dev/)

eszközök

[CLI cloudcart.dev/docs/cli](https://cloudcart.dev/docs/cli)
[AI Toolkit · GitHub github.com/cloudcart/ai-toolkit](https://github.com/cloudcart/ai-toolkit)
[Postman postman.com/cloudcartapi/cloudcart-public](https://www.postman.com/cloudcartapi/cloudcart-public/collection/rb83ao3/cloudcart-api)
[GPT asszisztens az API-hoz chatgpt.com/g/…official-cloudcart-api](https://chatgpt.com/g/g-67d8113d687081918f764e71c844d13b-official-cloudcart-api)
segítség és partnerek

[Tudástár help.cloudcart.com](https://help.cloudcart.com/en/support/home)
[Partnerek /partners](https://cloudcart.com/hu/partners)

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

X-RateLimit-Limit: 100X-RateLimit-Remaining: 100429 · Retry-After: 60
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.

[### Partnerek Ügynökségek és szakemberek keresnek a CloudCarttal szakértőként, affiliate-ként vagy viszonteladóként Fedezze fel →](https://cloudcart.com/hu/partners)
[### CloudCart Pay Bankkártyás fizetés banki szerződés nélkül Fedezze fel →](https://cloudcart.com/hu/cloudcart-pay)
[### AURA Az AI munkatárs: termékleírást és SEO-szöveget ír, fordít, kampányokat javasol Fedezze fel →](https://cloudcart.com/hu/aura)

## 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](https://cloudcart.com/hu/contact)