Ξεκίνησε τώρα

Για προγραμματιστές

API για προγραμματιστές: μια πλατφόρμα που καταλαβαίνουν ο κώδικας και το AI σου

Admin GraphQL, Storefront API, REST και webhooks. CLI με έξοδο JSON σε κάθε εντολή. Dev MCP, με το οποίο ο AI agent σου διαβάζει το schema και ελέγχει το query πριν το εκτελέσει. Όλα τεκμηριώνονται στο cloudcart.dev.

Ξεκίνησε τώρα Πύλη προγραμματιστών

GraphQL και REST · CLI και Dev MCP · Headless βιτρίνες

AI Toolkit στο GitHub

Τρία API

Ένα API για κάθε εργασία

REST για εξωτερικές συνδέσεις, Admin GraphQL για τον πίνακα διαχείρισης και τους agents, Storefront GraphQL για τη βιτρίνα. Το ίδιο κατάστημα πίσω και από τα τρία.

/api/v2

JSON-API v2 · REST

  • Εξωτερικές συνδέσεις: ERP, Make, Zapier, scripts
  • Κλειδί API ανά κατάστημα
  • JSON:API 1.0, ένας πόρος ανά αίτημα
GET /api/v2/products?filter[sku]=RS-30 X-CloudCart-ApiKey: ••• Accept: application/vnd.api+json
Τεκμηρίωση
/api/gql

Admin GraphQL

  • Αυτοπεριγραφικό schema με introspection
  • Personal Access Token, καταγραφή ελέγχου για κάθε mutation
  • Αυτό χρησιμοποιούν το CLI και οι AI agents
POST /api/gql { products(first: 1, sku: "RS-30") { edges { node { id name pricing { from } } } } }
Τεκμηρίωση
/api/sf

Storefront GraphQL

  • Headless βιτρίνες: Next.js, Nuxt, SvelteKit, Remix, Astro
  • Storefront token με καθορισμένο scope + JWT πελάτη
  • Αιτήματα από τον browser του πελάτη
POST /api/sf X-Storefront-Access-Token: ••• { product(handle: "serum-s-rozovo-maslo") { title priceRange { minVariantPrice { formatted } } } }
Τεκμηρίωση
01Webhooks σε πραγματικό χρόνο για κάθε αλλαγή σε παραγγελία, προϊόν ή πελάτη. Τεκμηρίωση →
02Tokens: κλειδιά API για τις συνδέσεις, Personal Access Tokens για CLI και GraphQL, Storefront tokens με καθορισμένο scope για τις βιτρίνες.

AI Toolkit και CLI

Συνεργάζεται με τον AI agent σου

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

Το CloudCart CLI είναι ένα εργαλείο γραμμής εντολών για το κατάστημά σου, σχεδιασμένο με γνώμονα τους AI agents. Είναι ενσωματωμένο και λειτουργεί αμέσως. Κάθε εντολή επιστρέφει JSON και έναν σαφή κωδικό εξόδου - αν εκτελέστηκε επιτυχώς και, αν όχι, γιατί. Έτσι, ένα script ή ένας AI agent το χρησιμοποιεί εξίσου εύκολα με έναν προγραμματιστή.

Έξοδος JSONκαι κωδικοί εξόδου σε κάθε εντολή
Αυτοματοποίηση με scriptsαπό agents και CI
Κατανόηση εικόνωνστη γραμμή εντολών

Δες στο GitHub

Δημιουργείς μια νέα σύνδεση

Την περιγράφεις και το Claude δημιουργεί τις ενέργειες GraphQL, τις επικυρώνει και συνδέει τη λογική

› «Συγχρόνισε τα αποθέματα από το WMS μας κάθε ώρα»

Γράφεις και δοκιμάζεις queries

Το Claude διαβάζει το schema, γράφει το query και το ελέγχει μέσω του Dev MCP πριν από την εκτέλεση

› «Ποια προϊόντα δεν έχουν φωτογραφία;»

Προσχέδια components του Nitrogen

Component για τη βιτρίνα του καταστήματος, πάνω στο Storefront API, έτοιμο για το framework σου

› «Κάρτα προϊόντος με επιλογή παραλλαγής»

Το Dev MCP δίνει τις ίδιες δυνατότητες στο Claude, το Cursor και τους άλλους AI clients: διαβάζουν το schema και ελέγχουν το query πριν το εκτελέσουν.

Nitrogen - η headless τεχνολογία μας

Γράψε τη βιτρίνα του καταστήματός σου με το framework που ξέρεις

Η βιτρίνα του καταστήματος είναι η δική σου εφαρμογή σε Next.js, Nuxt, SvelteKit, Remix ή Astro, πάνω στο Storefront API. Ο κατάλογος, οι παραγγελίες, οι πληρωμές και τα αποθέματα παραμένουν στο CloudCart.

localhost:5173dev

Τρεις εκδοχές · διάλεξε μία

Το γλωσσικό σου μοντέλοΠερίγραψε την αλλαγή…

Η αρχική σελίδα του ενδεικτικού καταστήματος tokatastimasou.gr. Ο developer γράφει στο γλωσσικό του μοντέλο «Δώσε μου τρεις φθινοπωρινές εκδοχές της αρχικής» και παίρνει τρεις εκδοχές: ζεστούς τόνους, σκούρο banner και φωτογραφία σε πλήρες μέγεθος. Η επιλεγμένη εκδοχή γίνεται η αρχική σελίδα - η αλλαγή γίνεται στον κώδικα της βιτρίνας του καταστήματος.

Τα API

  • Storefront GraphQL με δημόσιο και ιδιωτικό token
  • Customer Account API: σύνδεση χωρίς κωδικό πρόσβασης, με 6ψήφιο κωδικό
  • Το υπάρχον θέμα και το Nitrogen λειτουργούν ταυτόχρονα, σε διαφορετικά domains

Deploy και Nova

  • cloudcart nitrogen deploy από το CLI ή το CI σου
  • Ή GitHub App: deploy σε κάθε push
  • Nova: Cloudflare Workers, <handle>.nova.cloudcart.dev, preview και production, μεταβλητές περιβάλλοντος

Τι υλοποιείς εσύ

  • robots.txt και sitemap.xml
  • Τις ανακατευθύνσεις 301
  • Τη φόρμα επικοινωνίας και τη συγκατάθεση για cookies

Αυτά δεν παρέχονται αυτόματα σε ένα Nitrogen domain - τα υλοποιεί η εφαρμογή σου. Η διαδικασία περιγράφεται στην τεκμηρίωση.

Τεκμηρίωση Nitrogen

Χρήσιμο υλικό

Άμεσοι σύνδεσμοι

Όρια και κανόνες

Τα ξέρεις από πριν, όχι μετά το πρώτο 429

Τα όρια είναι δημόσια, για να σχεδιάσεις τη σύνδεση πριν γράψεις τον κώδικα.

Αιτήματα ανά λεπτό, ανά πακέτο

Το όριο αφορά το JSON-API v2 (/api/v2). Κάθε απόκριση περιλαμβάνει X-RateLimit-Limit, X-RateLimit-Remaining και Retry-After. Σε περίπτωση υπέρβασης - 429 με σώμα JSON. Όλα τα κλειδιά του καταστήματος μοιράζονται ένα κοινό όριο.

Webhooks

Ο παραλήπτης πρέπει να απαντά με 2xx και να αντέχει τις αιχμές - μια μαζική αλλαγή στον κατάλογο στέλνει πολλά συμβάντα ταυτόχρονα. Μια διεύθυνση που επιστρέφει συνεχώς σφάλμα απενεργοποιείται αυτόματα.

Η παράδοση ενός webhook περιμένει έως 30 δευτερόλεπτα.

Χρονικά όρια

30 δευτερόλεπτα ανά αίτημα στο JSON-API v2 και στον πίνακα διαχείρισης. Αν μια μεγάλη ανάκτηση δεδομένων δεν ολοκληρώνεται σε αυτό το διάστημα, χρησιμοποιείται σελιδοποίηση, όχι παράταση του χρονικού ορίου.

Οι μηχανισμοί προστασίας από κατάχρηση (bots, flood) δεν δημοσιοποιούνται. Ένας client που τους ενεργοποιεί λαμβάνει 429 ή 403.

Μίλησε με τους μηχανικούς μας

Φέρνεις την εργασία σου, σου δείχνουμε ποιο API την καλύπτει και πού θα βρεις την τεκμηρίωση.

Μίλησε με έναν σύμβουλο της CloudCart