May 03, 2026

Intégrez vos événements partout : un flux JSON public pour chaque boutique

Vos événements ont toujours vécu sur votre boutique Usetix. Aujourd’hui ils vivent aussi sur tous les autres sites où vous les voulez.

Chaque événement publié de votre boutique est désormais disponible en JSON sur la même URL — ajoutez simplement .json (ou envoyez Accept: application/json). Pas de token, pas d’inscription, pas de proxy. Déposez quelques lignes de JavaScript sur le site du groupe, le hub du festival ou la page listings d’un partenaire, et votre lineup complet s’y affiche, automatiquement.

Ce que vous obtenez

curl -H "Accept: application/json" \
  https://your-subdomain.usetix.io/events

Renvoie vos événements publiés à venir avec tout ce dont une page tierce a besoin pour les afficher : titre, dates, lieu (avec lat/lng pour les cartes), images, flag complet, prix le plus bas disponible, et une URL d’achat directe.

GET /events/spring-showcase.json ajoute billets, artistes et FAQ pour un seul événement.

C’est tout. Deux endpoints, publics, sans auth.

Conçu pour l’intégration

Quelques opinions intégrées :

CORS ouvert à toutes les origines. Fetch depuis n’importe quel navigateur, n’importe quel domaine.
Cache-Control: public, max-age=60 : votre CDN, votre reverse proxy, même le navigateur du visiteur le cacheront volontiers une minute.
ETag sur le détail d’événement : les fetches répétés renvoient 304 Not Modified et un corps vide quand rien n’a changé.
URLs d’images absolues : déposez-les directement dans <img src=...> depuis n’importe quelle origine.
Argent sous forme { amount, currency } : même forme que le reste de l’API, pas de symboles, pas de flottants.

<div id="next-event"></div>

<script>
  fetch("https://your-subdomain.usetix.io/events.json")
    .then(r => r.json())
    .then(data => {
      const next = data.events[0];
      if (!next) return;
      document.getElementById("next-event").innerHTML = `
        <a href="${next.url}">
          <img src="${next.image_url}" alt="">
          <h3>${next.title}</h3>
          <p>${new Date(next.starts_at).toLocaleString()} · ${next.venue.name}</p>
        </a>`;
    });
</script>

Déposez ça sur le WordPress du groupe, le Squarespace du lieu, la landing statique du festival. Ça se rafraîchit tout seul au prochain chargement de page, et dès que vous publiez un nouvel événement dans Usetix, il est là.

Ce qui n’est pas dans le flux

Le flux public n’expose que ce que votre boutique montre déjà publiquement. Brouillons, billets masqués sans code d’accès, chiffres de capacité, stock de billets, données clients, données de commande — rien de tout cela n’y figure. Pour tout ça, plus l’accès en écriture complet, utilisez l’API admin authentifiée.

Essayez

Prenez n’importe quel événement de votre compte, publiez-le, et demandez son slug :

curl https://your-subdomain.usetix.io/events.json

La référence complète — chaque champ, chaque endpoint, avec des exemples d’intégration — est sur usetix.io/docs/api/public-events.

Vous construisez quelque chose de cool avec ? Dites-le-nous à support@usetix.io.

Ce que vous obtenez

Conçu pour l’intégration

Un widget « prochain événement » en 10 lignes

Ce qui n’est pas dans le flux

Essayez