vcity logo
InicioSolucionesExplorar
PARA DESARROLLADORES

Construye sobre Vcity

API REST pública, CLI oficial y SDK de TypeScript. Consulta orgs, productos, eventos, órdenes, reservas y cotizaciones — de forma programática.

Instalar el CLI

Todo lo que necesitas para lanzar

Una API moderna más herramientas para integrar Vcity en tu stack.

API REST

Endpoints de lectura para orgs, productos, eventos, órdenes, reservas y cotizaciones. Versionado en /api/v1. OpenAPI 3.1.

Autenticación Bearer con claves de API

Genera llaves por org desde el panel de administración de tu org. Limitadas a una sola org. Rótalas o revócalas cuando quieras.

SDK oficial de TypeScript

@vcityio/api-client — respuestas tipadas generadas a partir de la especificación OpenAPI. ESM, Node 20+ y navegadores modernos.

CLI de Vcity

Autentícate mediante device flow, lista tus orgs, cambia de contexto y explora productos desde tu terminal.

Webhooks

Pronto

Reacciona a eventos — órdenes, confirmaciones, pagos — en tus propios servicios.

Explorador OpenAPI

Explora cada endpoint con ejemplos en /docs/api. Prueba peticiones directamente desde la página.

Obtén tu clave de API en dos minutos

Las claves viven dentro del panel de tu organización. Cada clave tiene alcance a una sola organización y se puede rotar o revocar en cualquier momento.

  1. 1

    Crea o elige una organización

    Ve al panel de administración de tu organización.

  2. 2

    Abre la pestaña Claves de API

    Se encuentra en la configuración de admin de tu org en /orgs/<id>/admin/api-keys.

  3. 3

    Genera y copia

    El secreto completo se muestra una sola vez — guárdalo de forma segura. Úsalo como Bearer token en el header Authorization.

Abrir mis organizaciones →
Authorization header
Authorization: Bearer vck_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Instala el CLI

Instalación en una línea. Se autentica mediante device flow — sin contraseñas ni tokens que copiar.

Instalar
curl -fsSL https://vcity.io/cli/install.sh | bash
Iniciar sesión
vcity login
Ejecutar un comando
vcity orgs list

Comunícate con la API

Usa curl directamente o el SDK oficial de TypeScript.

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

Qué puedes construir

Cualquier cosa que involucre el comercio, contenido o presencia 3D de tu organización.

Sincronizar inventario

Envía productos desde tu ERP o PIM a las tiendas de vcity. Mantén el stock y los precios sincronizados.

Automatizar eventos

Crea eventos, gestiona asistentes y obtén analíticas desde tus propias herramientas.

Checkout personalizado

Crea flujos de compra embebidos en tu sitio que se procesan dentro de vcity.

3D headless

Genera espacios 3D con tu marca bajo demanda y embébelos donde quieras.

Flujos basados en webhooks

Pronto

Dispara alertas de Slack, actualizaciones de CRM o fulfillment cuando ocurre una venta o un RSVP.

Herramientas internas

Pronto

Crea dashboards de administración sobre los datos de tu organización sin rehacer la UI.

Open source en GitHub

Tanto el CLI como el cliente de TypeScript son open source y están versionados en npm.

@vcityio/cli en npm →@vcityio/api-client en npm →Ver en GitHub →

Empieza a construir

Pruébalo gratis, sin tarjeta de crédito. La API es el mismo motor que impulsa vcity.io.

Leer la documentación de la API →Instalar el CLI