vcity logo
ΑρχικήΛύσειςΕξερεύνηση
ΓΙΑ ΠΡΟΓΡΑΜΜΑΤΙΣΤΕΣ

Αναπτύξτε στο vcity

Δημόσιο REST API, επίσημο CLI και TypeScript SDK. Κάντε ερωτήματα για οργανισμούς, προϊόντα, εκδηλώσεις, παραγγελίες, κρατήσεις και προσφορές — προγραμματιστικά.

Εγκαταστήστε το CLI

Όλα όσα χρειάζεστε για να ξεκινήσετε

Μια σύγχρονη επιφάνεια API και εργαλεία για την ενσωμάτωση του vcity στο stack σας.

REST API

Endpoints ανάγνωσης για οργανισμούς, προϊόντα, εκδηλώσεις, παραγγελίες, κρατήσεις και προσφορές. Με έκδοση στο /api/v1. OpenAPI 3.1.

Bearer authentication με κλειδιά API

Δημιουργήστε κλειδιά ανά οργανισμό από τον πίνακα διαχείρισης του οργανισμού σας. Περιορισμένα σε έναν μόνο οργανισμό. Ανανεώστε ή ανακαλέστε ανά πάσα στιγμή.

Επίσημο TypeScript SDK

@vcityio/api-client — typed απαντήσεις που παράγονται από την προδιαγραφή OpenAPI. ESM, Node 20+ και σύγχρονοι browsers.

vcity CLI

Πιστοποιηθείτε μέσω device flow, δείτε τη λίστα των οργανισμών σας, αλλάξτε πλαίσιο και περιηγηθείτε σε προϊόντα από το terminal σας.

Webhooks

Σύντομα

Αντιδράστε σε γεγονότα — παραγγελίες, RSVPs, πληρωμές — στις δικές σας υπηρεσίες.

OpenAPI explorer

Περιηγηθείτε σε κάθε endpoint με παραδείγματα στο /docs/api. Δοκιμάστε αιτήματα απευθείας από τη σελίδα.

Αποκτήστε το κλειδί API σας σε δύο λεπτά

Τα κλειδιά βρίσκονται μέσα στο dashboard του οργανισμού σας. Κάθε κλειδί αντιστοιχεί σε έναν μόνο οργανισμό και μπορεί να εναλλαχθεί ή να ανακληθεί οποτεδήποτε.

  1. 1

    Δημιουργήστε ή επιλέξτε έναν οργανισμό

    Μεταβείτε στο admin panel του οργανισμού σας.

  2. 2

    Ανοίξτε την καρτέλα API Keys

    Βρίσκεται κάτω από τις ρυθμίσεις διαχείρισης του οργανισμού σας, στο /orgs/<id>/admin/api-keys.

  3. 3

    Δημιουργήστε και αντιγράψτε

    Το πλήρες μυστικό εμφανίζεται μία φορά — αποθηκεύστε το με ασφάλεια. Χρησιμοποιήστε το ως Bearer token στην κεφαλίδα Authorization.

Άνοιγμα των οργανισμών μου →
Authorization header
Authorization: Bearer vck_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Εγκατάσταση του CLI

Εγκατάσταση με μία γραμμή. Ταυτοποίηση μέσω device flow — χωρίς κωδικούς, χωρίς αντιγραφή tokens.

Εγκατάσταση
curl -fsSL https://vcity.io/cli/install.sh | bash
Σύνδεση
vcity login
Εκτέλεση εντολής
vcity orgs list

Επικοινωνία με το API

Χρησιμοποιήστε απευθείας το curl ή το επίσημο TypeScript SDK.

bash
curl https://vcity.io/api/v1/orgs/your-org/products \
  -H "Authorization: Bearer $VCITY_API_KEY" \
  -H "Content-Type: application/json"

Τι μπορείτε να φτιάξετε

Οτιδήποτε αφορά το εμπόριο, το περιεχόμενο ή την 3D παρουσία του οργανισμού σας.

Συγχρονισμός αποθέματος

Στείλτε προϊόντα από το ERP ή το PIM σας στα καταστήματα του vcity. Διατηρήστε απόθεμα και τιμές απόλυτα συγχρονισμένα.

Αυτοματοποίηση εκδηλώσεων

Δημιουργήστε εκδηλώσεις, διαχειριστείτε συμμετέχοντες και αντλήστε αναλυτικά στοιχεία από τα δικά σας εργαλεία.

Προσαρμοσμένο checkout

Δημιουργήστε ενσωματωμένες ροές αγοράς στον ιστότοπό σας που ολοκληρώνονται μέσα στο vcity.

Headless 3D

Δημιουργήστε branded 3D χώρους κατ' απαίτηση και ενσωματώστε τους οπουδήποτε.

Ροές εργασίας με webhooks

Σύντομα

Ενεργοποιήστε ειδοποιήσεις Slack, ενημερώσεις CRM ή εκτέλεση παραγγελιών όταν συμβαίνει μια πώληση ή ένα RSVP.

Εσωτερικά εργαλεία

Σύντομα

Δημιουργήστε πίνακες διαχείρισης πάνω από τα δεδομένα του οργανισμού σας χωρίς να ξαναχτίσετε το UI.

Ανοιχτού κώδικα στο GitHub

Τόσο το CLI όσο και ο TypeScript client είναι ανοιχτού κώδικα και εκδίδονται μέσω npm.

@vcityio/cli στο npm →@vcityio/api-client στο npm →Προβολή στο GitHub →

Ξεκινήστε να δημιουργείτε

Δωρεάν δοκιμή, χωρίς πιστωτική κάρτα. Το API είναι η ίδια μηχανή που τροφοδοτεί το vcity.io.

Διαβάστε την τεκμηρίωση του API →Εγκατάσταση του CLI