vcity logo
AccueilSolutionsExplorer
POUR LES DÉVELOPPEURS

Construisez sur vcity

API REST publique, CLI officielle et SDK TypeScript. Interrogez les organisations, produits, événements, commandes, réservations et devis — par programmation.

Installer le CLI

Tout ce qu'il faut pour livrer

Une API moderne et des outils pour intégrer vcity à votre stack.

API REST

Endpoints de lecture pour les organisations, produits, événements, commandes, réservations et devis. Versionnés sous /api/v1. OpenAPI 3.1.

Authentification Bearer avec clés API

Générez des clés par organisation depuis votre panneau d'administration. Limitées à une seule organisation. Renouvelables ou révocables à tout moment.

SDK TypeScript officiel

@vcityio/api-client — réponses typées générées à partir de la spécification OpenAPI. ESM, Node 20+ et navigateurs modernes.

CLI vcity

Authentifiez-vous via le device flow, listez vos organisations, changez de contexte et parcourez les produits depuis votre terminal.

Webhooks

Bientôt

Réagissez aux événements — commandes, RSVP, paiements — dans vos propres services.

Explorateur OpenAPI

Parcourez chaque endpoint avec des exemples sur /docs/api. Essayez les requêtes directement depuis la page.

Obtenez votre clé API en deux minutes

Les clés sont disponibles dans le tableau de bord de votre organisation. Chaque clé est limitée à une seule organisation et peut être renouvelée ou révoquée à tout moment.

  1. 1

    Créez ou sélectionnez une organisation

    Accédez au panneau d'administration de votre organisation.

  2. 2

    Ouvrez l'onglet Clés API

    Disponible dans les paramètres d'administration de votre organisation à /orgs/<id>/admin/api-keys.

  3. 3

    Générez et copiez

    Le secret complet ne s'affiche qu'une seule fois — conservez-le en lieu sûr. Utilisez-le comme Bearer token dans l'en-tête Authorization.

Ouvrir mes organisations →
Authorization header
Authorization: Bearer vck_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Installer le CLI

Installation en une ligne. Authentification via device flow — pas de mots de passe, pas de tokens à copier.

Installer
curl -fsSL https://vcity.io/cli/install.sh | bash
Se connecter
vcity login
Exécuter une commande
vcity orgs list

Dialoguer avec l'API

Utilisez curl directement ou le SDK TypeScript officiel.

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

Ce que vous pouvez créer

Tout ce qui touche au commerce, au contenu ou à la présence 3D de votre organisation.

Synchroniser l'inventaire

Envoyez vos produits depuis votre ERP ou PIM vers les boutiques vcity. Gardez stocks et prix parfaitement alignés.

Automatiser les événements

Créez des événements, gérez les participants et extrayez les analytics depuis vos propres outils.

Paiement personnalisé

Intégrez des parcours d'achat sur votre site, traités directement dans vcity.

3D headless

Créez à la demande des espaces 3D à votre image et intégrez-les partout.

Workflows pilotés par webhooks

Bientôt

Déclenchez des alertes Slack, des mises à jour CRM ou l'expédition dès qu'une vente ou un RSVP a lieu.

Outils internes

Bientôt

Créez des tableaux de bord d'administration sur les données de votre organisation sans reconstruire l'interface.

Open source sur GitHub

Le CLI et le client TypeScript sont ouverts et versionnés sur npm.

@vcityio/cli sur npm →@vcityio/api-client sur npm →Voir sur GitHub →

Commencer à créer

Essai gratuit, sans carte bancaire. L'API est le même moteur que celui qui propulse vcity.io.

Lire la documentation de l'API →Installer le CLI