vcity logo
HomeSoluzioniEsplora
PER GLI SVILUPPATORI

Crei su Vcity

API REST pubblica, CLI ufficiale e SDK TypeScript. Interroghi organizzazioni, prodotti, eventi, ordini, prenotazioni e preventivi — in modo programmatico.

Installa la CLI

Tutto ciò di cui ha bisogno per partire

Una superficie API moderna e strumenti per integrare Vcity nel suo stack.

API REST

Endpoint di lettura per organizzazioni, prodotti, eventi, ordini, prenotazioni e preventivi. Versionati su /api/v1. OpenAPI 3.1.

Autenticazione Bearer con chiavi API

Generi chiavi per ogni organizzazione dal pannello di amministrazione. Limitate a una singola organizzazione. Le ruoti o le revochi in qualsiasi momento.

SDK TypeScript ufficiale

@vcityio/api-client — risposte tipizzate generate dalla specifica OpenAPI. ESM, Node 20+ e browser moderni.

Vcity CLI

Si autentichi tramite device flow, elenchi le Sue organizzazioni, cambi contesto ed esplori i prodotti dal Suo terminale.

Webhook

Presto

Reagisca agli eventi — ordini, RSVP, pagamenti — nei suoi servizi.

Esploratore OpenAPI

Sfogli ogni endpoint con esempi su /docs/api. Provi le richieste direttamente dalla pagina.

Ottenga la sua chiave API in due minuti

Le chiavi si trovano nella dashboard della sua organizzazione. Ogni chiave ha ambito limitato a una singola organizzazione e può essere ruotata o revocata in qualsiasi momento.

  1. 1

    Crei o selezioni un'organizzazione

    Vada al pannello di amministrazione della sua organizzazione.

  2. 2

    Apra la scheda Chiavi API

    Si trova nelle impostazioni di amministrazione della sua organizzazione su /orgs/<id>/admin/api-keys.

  3. 3

    Generi e copi

    Il secret completo viene mostrato una sola volta — lo conservi in un luogo sicuro. Lo utilizzi come Bearer token nell'header Authorization.

Apri le mie organizzazioni →
Authorization header
Authorization: Bearer vck_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Installa la CLI

Installazione in una riga. Autenticazione tramite device flow — niente password, niente token da copiare.

Installa
curl -fsSL https://vcity.io/cli/install.sh | bash
Accedi
vcity login
Esegui un comando
vcity orgs list

Comunica con l'API

Usi curl direttamente oppure l'SDK ufficiale per TypeScript.

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

Cosa può costruire

Tutto ciò che riguarda commercio, contenuti o presenza 3D della sua organizzazione.

Sincronizza l'inventario

Invii i prodotti dal suo ERP o PIM ai negozi vcity. Mantenga scorte e prezzi sempre allineati.

Automatizza gli eventi

Crei eventi, gestisca i partecipanti ed estragga analytics dai suoi strumenti.

Checkout personalizzato

Costruisca flussi d'acquisto integrati nel suo sito che si concludono in vcity.

3D headless

Generi spazi 3D brandizzati su richiesta e li incorpori ovunque.

Workflow basati su webhook

Presto

Attivi notifiche Slack, aggiornamenti CRM o spedizioni quando avviene una vendita o una conferma di partecipazione.

Strumenti interni

Presto

Crei dashboard di amministrazione sui dati della sua organizzazione senza ricostruire la UI.

Open source su GitHub

Sia la CLI sia il client TypeScript sono open source e versionati su npm.

@vcityio/cli su npm →@vcityio/api-client su npm →Visualizza su GitHub →

Inizi a costruire

Provi gratuitamente, senza carta di credito. L'API è lo stesso motore che alimenta vcity.io.

Leggi la documentazione dell'API →Installa la CLI