Viventii
Chercher des événementsRelease Radar
Se connecterS'inscrire
Viventii
Viventii Logo

Découvrez des événements locaux, des concerts, des ateliers et plus encore avec Viventii.

Découvrir

Voir toutes les villes

Catégories

Fêtes & ClubbingMusique & FestivalsSalons & FoiresShopping & MarchésBars & RestaurantsFamille & EnfantsVoir toutes les catégories

Entreprise

Emplois & CarrièreFAQAssistance & ContactPromotions et offres

Découvrez la vie nocturne ou planifiez vos propres moments forts privés. Qu'il s'agisse d'un grand concert ou d'une soirée jeux conviviale entre amis – Viventii réunit tout le monde.

Mentions légalesPolitique de confidentialitéConditions d'utilisationPolitique relative aux cookiesSources de données et licences

© ... Viventii UG (haftungsbeschränkt). Tous droits réservés.

DécouvrirCarteRadarBillets
DécouvrirCarteRadarBillets

Documentation développeur

Référence complète pour l'API organisateur Viventii.

Télécharger la spécification OpenAPI

API Viventii – Documentation Complète (A-Z)

Cette documentation décrit chaque fonction, chaque endpoint et chaque possibilité d'intégration de l'API Viventii – sans raccourcis.

Base URL: https://viventii.com/api/v1/organizer

🚀 0. Démarrage Rapide : Générateur de Code Interactif

Utilisez notre outil interactif pour générer du code prêt à l'emploi pour votre système. Saisissez simplement votre clé API et un nom pour votre système – notre Universal Sync s'occupe du reste automatiquement.


🔐 1. Authentification & Clés API

Qu'est-ce qu'une clé API ?

Une clé API est une clé secrète qui permet à votre système d'agir au nom de votre compte Viventii. Format : sk_live_a1b2c3d4e5f6...

Comment obtenir une clé API ?

  1. Ouvrez votre Tableau de bord Viventii
  2. Allez dans Profil → Développeur
  3. Cliquez sur "Créer une clé API"
  4. Choisissez un Nom et des Autorisations (Scopes)
  5. La clé s'affiche une seule fois – enregistrez-la immédiatement en lieu sûr !

Scopes (Autorisations)

ScopeDroitsQuand l'utiliser ?
readLire les donnéesIdéal pour les widgets, les statistiques ou les systèmes de sauvegarde.
writeCréer & modifier des donnéesNécessaire pour la synchronisation CMS (WordPress/Shopify) et les applications d'entrée.
adminAccès completÀ utiliser uniquement pour les outils internes ou les systèmes de gestion d'équipe.

Flux d'Authentification

  1. Requête : Votre serveur envoie une requête HTTP à Viventii.
  2. En-tête : Vous ajoutez l'en-tête Authorization: Bearer sk_live_....
  3. Validation : Viventii vérifie la clé et vos autorisations (Scopes).
  4. Identification : Viventii attribue la requête à votre organisation.
  5. Réponse : Vous recevez les données (200 OK) ou un message d'erreur (401 Unauthorized).

Meilleures Pratiques de Sécurité

  • Ne jamais utiliser sur le frontend : Une clé API appartient au backend (Node.js, PHP, Python). Elle ne doit jamais apparaître dans le code JavaScript d'un site web (danger de vol !).
  • Principe des deux clés : Utilisez des clés distinctes pour différents systèmes (par exemple, une clé pour WordPress, une pour l'application de scanner). Si un système est compromis, vous n'avez qu'à révoquer une seule clé.
  • Rotation : Renouvelez vos clés tous les 6 à 12 mois.

Alternative : Firebase ID Token

Les applications mobiles (iOS/Android) peuvent envoyer un Firebase ID Token de l'utilisateur connecté au lieu d'une clé API. Viventii reconnaît l'utilisateur automatiquement et accorde les droits appropriés.

⚠️ La clé n'est affichée qu'UNE SEULE FOIS !


🧪 2. Mode Sandbox (Test vs. Live)

Viventii sépare strictement les données de test des données réelles en direct. Cela évite que des événements de test ne deviennent accidentellement visibles pour les clients.

Comparaison : Live vs. Test

FonctionnalitéMode Live (sk_live_...)Mode Test (sk_test_...)
VisibilitéPublic sur ViventiiUniquement pour vous (Brouillon/Privé)
BrandingTitre normalReçoit automatiquement [TEST] dans le titre
WebhooksVrais webhooksWebhooks de test (pour le développement)
ValiditéJuridiquement contraignantDonnées purement simulées

Flux de Travail Idéal pour les Développeurs

  1. Clé de test : Créez une clé de test (isTest: true) dans le Tableau de bord.
  2. Développement : Intégrez l'API et envoyez des événements de test à Viventii.
  3. Validation : Vérifiez dans le Tableau de bord sous "Événements de test" si tous les champs arrivent correctement.
  4. Mise en service : Créez une clé live dès que vos tests sont réussis.
  5. Basculement : Modifiez la variable d'environnement de votre serveur pour utiliser la clé live.

💡 Les clés live ne peuvent pas lire/écrire des événements de test et vice versa.


📝 3. Événements – Créer (POST /events)

Scope : write

Quand avez-vous besoin de cet endpoint ?

Chaque fois qu'un nouvel événement est créé dans votre système source (CMS, site web, base de données). C'est le point de départ de la synchronisation automatique.

Le Processus de Synchronisation (Universal Sync)

Viventii utilise un principe d'"Upsert" (Update or Insert). Vous n'avez pas besoin de stocker les ID Viventii dans votre base de données.

  • Étape 1 : Votre système envoie POST /events avec un sourceId (par exemple, votre ID d'article WordPress).
  • Étape 2 : Viventii vérifie : "Est-ce que je connais déjà ce sourceId pour cet organisateur ?"
    • Non : Un nouvel événement est créé.
    • Oui : L'événement existant est mis à jour avec les nouvelles données.
  • Étape 3 (Arrière-plan) :
    • 📍 Géocodage : L'adresse est convertie en coordonnées pour la carte.
    • 🌐 Traduction IA : Les textes sont automatiquement traduits en 6 langues.
    • 🔗 SEO : Un lien convivial (slug) est généré.
    • 🖼️ Flux d'actifs : Votre image est optimisée et téléchargée sur le CDN.
  • Étape 4 : Vous recevez une confirmation (action: "created" ou "updated").

Champs Importants & Détails

ChampSignificationConseil de Pro
sourceIdVOTRE IDL'ID de votre système source (ex. wp-123). Crucial pour l'auto-sync !
name_sourceTitreUtilisez le titre original de votre système.
description_sourceDescriptionHTML de base autorisé (p, br, strong).
externalTicketStatsVentes en directEnvoyez directement les chiffres de vente actuels (Vendus/Capacité) !
imageDataUriImage de titreEnvoyez l'image principale sous forme de chaîne Base64.
galleryImagesGalerie d'imagesUn tableau d'objets (URL ou Base64) pour des images supplémentaires.
seriesIdTournée/SérieUtilisez le même ID pour tous les événements d'une tournée.
capacityCapacitéImportant pour le calcul "Presque complet".

🛠️ Mapping des Champs & Schéma (IMPORTANT)

L'API Viventii utilise un schéma cible statique. Cela signifie : les noms de champs (clés) que vous nous envoyez (ex. name_source) doivent toujours être nommés exactement comme décrit dans cette documentation.

Comment fonctionne le mapping ? Votre système (ex. WordPress) possède ses propres noms de champs. Vous devez les "traduire" en nos noms dans votre code :

Votre champ (Exemple)Champ cible Viventii
$post->post_titlename_source
$meta['location']location
$event['start']date / time

Où se fait le mapping ? Le mapping se fait dans votre système (par exemple dans un cronjob, un script de synchronisation ou un middleware). Avant d'envoyer la requête POST à Viventii, vous affectez vos variables locales aux clés Viventii.

🔌 Conseil Spécial WordPress

Si vous utilisez WordPress, le mapping a généralement lieu dans le fichier functions.php de votre thème ou dans un plugin dédié. Un modèle éprouvé consiste à utiliser le hook save_post.

Le Principe du Pont (Important pour comprendre) Beaucoup demandent : 'Comment Viventii sait-il quel champ de mon système signifie quoi ?'

La réponse : Viventii ne le sait pas. Viventii est un récepteur passif (la cible). Votre système est l'émetteur actif (la source).

  1. Votre responsabilité : Vous écrivez un petit script (le pont) qui interroge les données de votre base de données.
  2. Le Mapping : Vous décidez dans ce script quelle valeur va dans quel champ Viventii.
  3. Le Push : Votre script 'pousse' (POST) les données entièrement traduites vers nous.
// Exemple de 'traduction' dans le fichier functions.php de WordPress : add_action('save_post', function($post_id) { // Étape A : Récupérer vos données internes $mon_titre_interne = get_the_title($post_id); $mon_adresse_interne = get_post_meta($post_id, 'wp_field_address', true); // Étape B : Mapping (Vous affectez votre valeur à notre clé) $payload = [ 'name_source' => $mon_titre_interne, // Traduction : Titre WP -> Clé Viventii 'location' => $mon_adresse_interne, // Traduction : Meta WP -> Clé Viventii 'sourceId' => 'wp-' . $post_id ]; // Étape C : Envoyer à Viventii wp_remote_post('https://api.viventii.com/v1/organizer/events', ['body' => json_encode($payload)]); }, 10, 1);

🚀 Perspective : Viventii Connect (Nocode)

Nous travaillons actuellement sur Viventii Connect, un plugin WordPress spécialisé.

  • Upload & Go : Plus besoin d'éditer le code.
  • Visual Mapping : Vous choisissez simplement dans une liste : 'Champ X de mon thème' -> 'Champ Y dans Viventii'.
  • Auto-Health : Le plugin vous avertit si une synchronisation échoue.

Si vous souhaitez tester la version bêta, contactez notre support !


📚 Référence Complète des Champs (60+ champs)

Pour exploiter tout le potentiel de l'IA Viventii, envoyez autant de détails que possible. L'IA utilise ces faits pour rédiger automatiquement des descriptions optimisées pour le SEO en 6 langues.

A. Métadonnées de base (Infrastructure)

ChampTypeObligatoireDescription
sourceIdString✅Votre ID. Empêche les doublons lors de l'auto-sync (ex. wp-123).
source_systemStringNonNom de votre système (ex. "Webshop 1").
name_sourceString✅Titre original de votre événement.
description_sourceString✅Description originale (HTML autorisé).
dateString✅Date au format YYYY-MM-DD.
timeString✅Heure de début au format HH:MM.
slugStringNonVotre permalien personnalisé (Viventii en génère un si vide).
seriesIdStringNonID d'une série d'événements ou d'une tournée.
organizationIdStringNonID de votre organisateur/lieu (pour les groupes).

B. Lieu & Adresse

ChampTypeObligatoireDescription
locationString✅Nom du lieu (ex. "Olympiastadion").
streetString✅Rue et numéro.
cityString✅Ville.
zipStringNonCode postal.
countryStringNonPays (par défaut : DE).
lat / lngNumberNonCoordonnées manuelles (sinon via auto-géocodage).

C. Accessibilité

ChampTypeDescription
isWheelchairAccessibleBooleanLe lieu est-il accessible aux fauteuils roulants ?
hasAccessibleRestroomsBooleanY a-t-il des toilettes accessibles ?
allowsServiceAnimalsBooleanLes animaux d'assistance sont-ils les bienvenus ?
hasSignLanguageBooleanL'événement est-il interprété en langue des signes ?
hasAutomaticDoorsBooleanY a-t-il des portes/entrées automatiques ?
accessibilityNotes_sourceStringDétails textuels sur l'accessibilité (ex. "Rampe à l'entrée arrière").

D. Gastronomie & Établissements

ChampTypeDescription
venueTypesArrayTypes : restaurant, cafe, bakery, ice_cream, cocktail_bar, wine_bar, beer_garden, pub, club, bistro, food_truck, fast_food, fine_dining_restaurant.
cuisineTypesArrayCuisines : german, italian, french, spanish, greek, turkish, asian, japanese, chinese, thai, indian, mexican, american, mediterranean, middle_eastern, vegetarian_vegan, seafood, steakhouse, pizza, burger, sushi, tapas, fusion, international, other.
dietaryOptionsArrayOptions : vegetarian, vegan, gluten_free, lactose_free, halal, kosher, organic, low_carb.
serviceOptionsArrayService : dine_in, takeaway, delivery, reservations, private_events, catering, brunch, happy_hour, outdoor_seating, live_music, sports_tv, air_conditioning, pets_allowed, smoking_area, rooftop, garden, fireplace.
atmosphereTypesArrayAmbiance : casual, cozy, romantic, family_friendly, trendy, upscale_elegant, rustic, modern, traditional, lively, quiet, business.
paymentMethodsArrayPaiement : cash, credit_card, debit_card, mobile_payment, voucher.
reservationUrlURLLien direct vers le système de réservation du restaurant.
priceRangeEnumGamme de prix : budget (€), moderate (€€), upscale (€€€), fine_dining (€€€€).

E. Logistique & Météo

ChampTypeDescription
publicTransportInfo_sourceStringDétails sur l'accès en bus/train.
parkingInfo_sourceStringOù se garer ? (Parking souterrain, parking, tarifs).
isWeatherDependentBooleanL'événement n'a-t-il lieu que par beau temps ?
weatherNotes_sourceStringQue se passe-t-il en cas de pluie ? (Couvert, option intérieure).

F. Programme & Lineup

ChampTypeDescription
lineupArrayListe des artistes : [{ "name": "Artiste A", "role": "Principal" }].
scheduleArrayEmploi du temps : [{ "time": "20:00", "title": "Début du spectacle" }].
doorsOpenTimeStringHeure d'ouverture des portes (format HH:MM).
presaleInfo_sourceStringInfos sur la prévente (ex. "Early Bird jusqu'en mai").

G. Marketing & Réseaux Sociaux

ChampTypeDescription
facebookUrlURLLien vers la page ou l'événement Facebook.
instagramUrlURLLien vers le profil Instagram.
twitterUrlURLLien vers le profil Twitter/X.
tiktokUrlURLLien vers le profil TikTok.
youtubeUrlURLLien vers un trailer ou une chaîne.
linkedinUrlURLLien pour les événements professionnels.
websiteUrlURLSite web officiel de l'événement.
trackingPixelsObjectID : facebook, google, tiktok, linkedin, snapchat.
specialOffers_sourceStringDescription des offres (ex. "2-pour-1 sur les boissons").

H. Tickets & Statistiques

ChampTypeDescription
ticketUrlURLLien vers la billetterie (apparaît sous forme de bouton).
externalTicketStatsObjectSync LIVE : source, totalSold, totalCapacity.
capacityNumberCapacité totale de l'événement.
priceNote_sourceStringInfo tarifaire textuelle (ex. "À partir de 15€ pour les étudiants").

I. Médias & Galerie

ChampTypeDescription
imageDataUriDataURIVotre image principale en Base64 (JPG/PNG).
galleryImagesArrayAutres impressions : [{ "url": "...", "caption": "..." }].

📋 4. Événements – Lister (GET /events)

Scope : read — Idéal pour synchroniser votre inventaire local avec Viventii.

Possibilités de Filtrage

ParamètreFonction
limitLimite le nombre de résultats (Standard : 20)
offsetPour la pagination (Page 1, 2, 3...)
organizationIdFiltre par une organisation spécifique

📄 5. Récupérer un Événement (GET /events/:id)

Scope : read — Renvoie l'enregistrement complet, incluant toutes les traductions générées par l'IA et les coordonnées.


✏️ 6. Mettre à jour un Événement (PATCH /events/:id)

Scope : write — Envoyez uniquement les champs qui ont réellement changé.


🗑️ 7. Supprimer un Événement (DELETE /events/:id)

Scope : write — Supprime l'événement et tous les médias de façon permanente du CDN.


🔄 8. Modifier le Statut de l'Événement (POST /events/:id/status)

Scope : write — Contrôle la visibilité et informe les clients.

Aperçu des Statuts

StatutEffet
activeVisible publiquement, les billets peuvent être vendus.
cancelledL'événement est marqué comme "Annulé". Le webhook est déclenché.
postponedMarké comme "Reporté".
draftVisible uniquement par vous. Par défaut pour les événements de test.

🎟️ 9. Stats de Vente de Billets (POST /events/:id/tickets/stats)

Scope : write — La partie la plus importante pour le "Live Feeling" sur Viventii.


👥 10. Sync de Listes de Participants (POST /events/:id/tickets/attendees)

Scope : write — Transférez vos données d'acheteurs vers Viventii pour l'entrée.


✅ 11. Check-in / Entrée (POST /events/:id/tickets/validate)

Scope : write — Si vous utilisez vos propres applications de scanner ou terminaux NFC.


📥 12. Exporter la Liste des Invités (GET /events/:id/tickets/export)

Scope : read — Idéal pour les scanners hors ligne ou les rapports.


📊 13. Stats d'Entrée en Direct (GET /events/:id/stats/entry)

Scope : read — Pour les tableaux de bord en direct sur le lieu de l'événement.


📈 14. Unified Ticket View (GET /events/:id/tickets)

Scope : read — Combine toutes les données de vente provenant de différentes sources.


📦 15. Inventaire & Contingents (PATCH /events/:id/inventory)

Scope : write — Gérez les contingents de billets par canal ou catégorie.


🔗 16. Webhooks – Enregistrement & Gestion

Que sont les Webhooks ?

Les webhooks sont des notifications automatiques que Viventii envoie à votre système.

ÉvénementQuand est-il déclenché ?
event.createdNouvel événement créé
event.updatedDonnées de l'événement modifiées
event.status_changedAnnulation, report, publication
event.ticket_soldBillet vendu via Viventii
event.attendee_addedNouveau participant ajouté

💳 17. Finance – Factures & Facturation

Scope : read — Récupère toutes les factures Stripe de votre compte Viventii.


📣 18. Audience Sync – Groupes Marketing de Cible

Scope : read — Exporte les hachages d'e-mails pour les Custom Audiences (Facebook, Google, etc.).


🛠️ 19. Support & Aide

Vous avez des questions sur l'intégration ? Notre équipe technique se fera un plaisir de vous aider.

  • E-mail : support@viventii.com
  • Web : Support & Contact

Bonne chance pour votre intégration !