vcity logo
StartseiteLösungenEntdecken
FÜR ENTWICKLER

Auf vcity aufbauen

Öffentliche REST API, offizielle CLI und TypeScript SDK. Fragen Sie Organisationen, Produkte, Veranstaltungen, Bestellungen, Buchungen und Angebote programmatisch ab.

CLI installieren

Alles, was Sie zum Launch brauchen

Eine moderne API plus Tooling, um vcity in Ihren Stack zu integrieren.

REST API

Lese-Endpunkte für Organisationen, Produkte, Veranstaltungen, Bestellungen, Buchungen und Angebote. Versioniert unter /api/v1. OpenAPI 3.1.

Bearer-Token-Authentifizierung mit API-Schlüsseln

Generieren Sie Schlüssel pro Organisation aus Ihrem Org-Admin-Panel. Auf eine einzelne Organisation beschränkt. Jederzeit rotier- oder widerrufbar.

Offizielles TypeScript SDK

@vcityio/api-client — typisierte Antworten, generiert aus der OpenAPI-Spezifikation. ESM, Node 20+ und moderne Browser.

vcity CLI

Authentifizieren Sie sich über den Device Flow, listen Sie Ihre Organisationen auf, wechseln Sie den Kontext und durchsuchen Sie Produkte von Ihrem Terminal aus.

Webhooks

Demnächst

Reagieren Sie auf Events — Bestellungen, RSVPs, Zahlungen — in Ihren eigenen Diensten.

OpenAPI Explorer

Durchsuchen Sie jeden Endpoint mit Beispielen unter /docs/api. Testen Sie Anfragen direkt auf der Seite.

Erhalten Sie Ihren API-Schlüssel in zwei Minuten

Schlüssel befinden sich in Ihrem Organisations-Dashboard. Jeder Schlüssel ist auf eine einzelne Org beschränkt und kann jederzeit rotiert oder widerrufen werden.

  1. 1

    Organisation erstellen oder auswählen

    Gehen Sie zu Ihrem Org-Admin-Panel.

  2. 2

    Öffnen Sie den Tab „API-Schlüssel“

    Zu finden in Ihren Org-Admin-Einstellungen unter /orgs/<id>/admin/api-keys.

  3. 3

    Generieren und kopieren

    Das vollständige Secret wird nur einmal angezeigt – speichern Sie es sicher. Verwenden Sie es als Bearer token im Authorization Header.

Meine Organisationen öffnen →
Authorization header
Authorization: Bearer vck_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

CLI installieren

Installation in einer Zeile. Authentifizierung per Device-Flow – keine Passwörter, kein Kopieren von Tokens.

Installieren
curl -fsSL https://vcity.io/cli/install.sh | bash
Anmelden
vcity login
Befehl ausführen
vcity orgs list

Mit der API kommunizieren

Verwenden Sie curl direkt oder das offizielle TypeScript SDK.

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

Was Sie entwickeln können

Alles, was den Commerce, die Inhalte oder die 3D-Präsenz Ihrer Organisation betrifft.

Inventar synchronisieren

Übertragen Sie Produkte aus Ihrem ERP oder PIM in Vcity-Shops. Halten Sie Bestand und Preise im Gleichschritt.

Events automatisieren

Erstellen Sie Events, verwalten Sie Teilnehmer und rufen Sie Analytics aus Ihren eigenen Tools ab.

Eigener Checkout

Bauen Sie eingebettete Kaufabläufe auf Ihrer Website, die innerhalb von Vcity abgewickelt werden.

Headless 3D

Starten Sie markenspezifische 3D-Räume auf Abruf und betten Sie diese überall ein.

Webhook-gesteuerte Workflows

Demnächst

Lösen Sie Slack-Benachrichtigungen, CRM-Updates oder Fulfillment aus, wenn ein Verkauf oder eine Anmeldung erfolgt.

Interne Tools

Demnächst

Erstellen Sie Admin-Dashboards für die Daten Ihrer Organisation, ohne die UI neu zu bauen.

Open Source auf GitHub

Sowohl die CLI als auch der TypeScript-Client sind offen und über npm versioniert.

@vcityio/cli auf npm →@vcityio/api-client auf npm →Auf GitHub ansehen →

Jetzt loslegen

Kostenlos testen, keine Kreditkarte. Die API ist dieselbe Engine, die vcity.io antreibt.

API-Dokumentation lesen →CLI installieren