Începe acum

Pentru dezvoltatori

API pentru dezvoltatori: o platformă pe care codul și AI-ul tău o înțeleg

Admin GraphQL, Storefront API, REST și webhooks. CLI cu ieșire JSON la fiecare comandă. Dev MCP, prin care agentul tău AI citește schema și verifică interogarea înainte să o execute. Totul este documentat pe cloudcart.dev.

Începe acum Portal pentru dezvoltatori

GraphQL și REST · CLI și Dev MCP · Vitrine headless

AI Toolkit pe GitHub

Trei API-uri

Un API pentru fiecare sarcină

REST pentru integrări externe, Admin GraphQL pentru panoul de administrare și agenți, Storefront GraphQL pentru vitrina magazinului. Același magazin în spatele tuturor celor trei.

/api/v2

JSON-API v2 · REST

  • Integrări externe: ERP, Make, Zapier, scripturi
  • Cheie API pentru fiecare magazin
  • JSON:API 1.0, o resursă per cerere
GET /api/v2/products?filter[sku]=RS-30 X-CloudCart-ApiKey: ••• Accept: application/vnd.api+json
Documentație
/api/gql

Admin GraphQL

  • Schemă autodescriptivă cu introspecție
  • Personal Access Token, audit pentru fiecare mutație
  • Folosit de CLI și de agenții AI
POST /api/gql { products(first: 1, sku: "RS-30") { edges { node { id name pricing { from } } } } }
Documentație
/api/sf

Storefront GraphQL

  • Vitrine headless: Next.js, Nuxt, SvelteKit, Remix, Astro
  • Token Storefront cu permisiuni definite + JWT pentru client
  • Cereri din browserul clientului
POST /api/sf X-Storefront-Access-Token: ••• { product(handle: "serum-s-rozovo-maslo") { title priceRange { minVariantPrice { formatted } } } }
Documentație
01Webhooks în timp real la fiecare modificare a unei comenzi, a unui produs sau a unui client. Documentație →
02Tokenuri: chei API pentru integrări, Personal Access Tokens pentru CLI și GraphQL, tokenuri Storefront cu permisiuni definite pentru vitrinele magazinelor.

AI Toolkit și CLI

Lucrează cu agentul tău AI

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

CloudCart CLI este o interfață în linie de comandă pentru magazinul tău, concepută pentru agenții AI. Este integrată și funcționează imediat. Fiecare comandă răspunde cu JSON și un cod de ieșire clar - dacă a reușit și, dacă nu, de ce. Astfel, un script sau un agent AI o poate folosi la fel de ușor ca un inginer.

Ieșire JSON și coduri de ieșire pentru fiecare comandă
Automatizare prin scripturi de către agenți și din CI
Înțelegerea imaginilor în linia de comandă

Vezi pe GitHub

Creezi o integrare nouă

O descrii, iar Claude generează operațiile GraphQL, le validează și conectează logica

› „Sincronizează stocurile din WMS-ul nostru la fiecare oră”

Scrii și testezi interogări

Claude citește schema, scrie interogarea și o verifică prin Dev MCP înainte de execuție

› „Ce produse nu au imagine?”

Schițe de componente Nitrogen

O componentă pentru vitrina magazinului, bazată pe Storefront API, pregătită pentru framework-ul tău

› „Card de produs cu selector de variante”

Dev MCP oferă același lucru pentru Claude, Cursor și ceilalți clienți AI: citesc schema și verifică interogarea înainte să o execute.

Nitrogen - tehnologia noastră headless

Dezvoltă vitrina magazinului cu framework-ul pe care îl cunoști

Vitrina magazinului este aplicația ta în Next.js, Nuxt, SvelteKit, Remix sau Astro, bazată pe Storefront API. Catalogul, comenzile, plățile și stocurile rămân în CloudCart.

localhost:5173dev

Trei versiuni · alege una

Modelul tău lingvisticDescrie modificarea…

Pagina de start a magazinului de exemplu magazinultau.ro. Dezvoltatorul îi scrie modelului său lingvistic „Dă-mi trei versiuni de toamnă ale paginii de start” și primește trei versiuni: tonuri calde, banner întunecat și imagine pe tot ecranul. Versiunea aleasă devine pagina de start - modificarea se face în codul vitrinei magazinului.

API-uri

  • Storefront GraphQL cu token public și privat
  • Customer Account API: autentificare fără parolă, cu un cod din 6 cifre
  • Tema existentă și Nitrogen funcționează simultan, pe domenii diferite

Deploy și Nova

  • cloudcart nitrogen deploy din CLI sau din CI-ul tău
  • Sau GitHub App: deploy la fiecare push
  • Nova: Cloudflare Workers, <handle>.nova.cloudcart.dev, preview și producție, variabile de mediu

Ce implementezi tu

  • robots.txt și sitemap.xml
  • Redirecționările 301
  • Formularul de contact și consimțământul pentru cookie-uri

Acestea nu sunt incluse automat pe un domeniu Nitrogen - aplicația ta le implementează. Găsești detaliile în documentație.

Documentație Nitrogen

Resurse

Linkuri directe

Limite și reguli

Comunicate din timp, nu după primul 429

Limitele sunt publice, ca să poți planifica integrarea înainte să scrii codul.

Cereri pe minut, în funcție de plan

Limita se aplică pentru JSON-API v2 (/api/v2). Fiecare răspuns include X-RateLimit-Limit, X-RateLimit-Remaining și Retry-After; la depășirea limitei - 429 cu un corp JSON. Toate cheile magazinului împart aceeași cotă.

Webhooks

Endpoint-ul receptor trebuie să răspundă cu 2xx și să poată gestiona vârfurile de trafic - o modificare în masă a catalogului trimite multe evenimente simultan. O adresă care returnează constant erori este dezactivată automat.

Timpul de așteptare pentru livrarea unui webhook este de până la 30 de secunde.

Timpi de așteptare

30 de secunde pentru o cerere către JSON-API v2 și către panoul de administrare. O citire de volum mare care nu se încadrează în acest interval se paginează, fără a prelungi timpul de așteptare.

Măsurile de protecție împotriva abuzurilor (boți, flood) nu sunt publicate; un client care le declanșează primește 429 sau 403.

Vorbește cu inginerii noștri

Tu vii cu cerința, noi îți arătăm ce API o rezolvă și unde găsești documentația.

Vorbește cu un consultant CloudCart