Affichez vos réservations sur votre site web avec l'API publique

Beaucoup d'agences et d'artistes affichent leurs prochaines dates sur leur propre site web : une page de tournée, un calendrier de concerts ou une simple liste de shows. L'API publique Artistu vous fournit un flux en lecture seule de vos réservations annoncées, pour que votre site web affiche toujours les mêmes dates que celles que vous gérez dans Artistu. Pas de copie manuelle, pas de pages de tournée obsolètes.

L'API est en lecture seule et n'expose que les informations que vous avez explicitement marquées comme publiques. Les cachets, les deals, les contacts, les notes internes et les shows non annoncés ne sont jamais inclus.

Comment ça fonctionne

Trois éléments travaillent ensemble :

Un jeton API, généré une seule fois dans vos paramètres Artistu, qui authentifie votre site web.
Des paramètres en ligne par réservation, qui contrôlent si une réservation est annoncée et quels détails publics elle contient.
Un seul endpoint qui renvoie les réservations annoncées d'un artiste au format JSON.

Générez votre jeton API

Allez dans Paramètres → Intégrations et trouvez la section API publique. Cliquez sur Générer un jeton. Vous devez être admin de votre organisation pour cela.

Le jeton est une chaîne de 64 caractères. Traitez-le comme un mot de passe : quiconque le possède peut lire vos données de réservations publiques. Il est masqué dans l'interface après la génération, utilisez le bouton Afficher pour le révéler à nouveau.

Deux autres actions sont disponibles une fois le jeton créé :

Régénérer le jeton crée un nouveau jeton et invalide immédiatement l'ancien. Tout site web ou intégration utilisant encore l'ancien jeton cesse de fonctionner sur-le-champ.
Révoquer le jeton supprime le jeton sans en créer un nouveau. Tout accès à l'API s'arrête jusqu'à ce que vous génériez un nouveau jeton.

Contrôlez quelles réservations apparaissent

Toutes les réservations n'ont pas leur place sur votre site web. Une réservation n'apparaît dans l'API que lorsque toutes les conditions suivantes sont remplies :

Le statut de la réservation est option ou confirmé. Les réservations en attente et annulées n'apparaissent jamais.
La réservation est annoncée : soit l'interrupteur Annoncé est activé, soit la date Annoncer le est passée.
L'interrupteur Masquer de l'API publique est désactivé.

Vous gérez cela par réservation. Ouvrez une réservation, allez dans l'onglet Paramètres et faites défiler jusqu'à la section En ligne. Vous y trouvez :

Champ	Rôle
Annoncer le	Date à laquelle la réservation devient automatiquement annoncée
Annoncé	Marquer manuellement la réservation comme annoncée dès maintenant
Masquer de l'API publique	Garder la réservation hors de l'API même lorsqu'elle est annoncée
Site web	Site web public de l'événement ou de la salle, inclus dans la réponse de l'API
Lien billetterie	Lien vers la vente de billets, inclus dans la réponse de l'API
Line-up	Texte public du line-up, inclus dans la réponse de l'API
Notes publiques	Tout texte public supplémentaire, inclus dans la réponse de l'API

La date Annoncer le est utile lorsqu'un show est confirmé mais sous embargo jusqu'à la date d'annonce officielle. Définissez la date, et la réservation apparaît automatiquement dans l'API à partir de ce jour.

Masquer de l'API publique est le contrôle prioritaire pour les shows annoncés ailleurs mais qui ne doivent pas figurer sur votre site web, par exemple des événements privés.

Trouvez votre ID d'artiste

L'API renvoie les réservations d'un artiste à la fois. Vous trouvez l'ID de l'artiste dans la barre d'adresse lorsque vous consultez l'artiste dans votre tableau de bord :

https://artistu.io/dashboard/artists/{artistId}

La dernière partie de l'URL est l'ID que vous passez à l'API. Si votre site web présente plusieurs artistes, faites une requête par artiste.

Récupérez les réservations

GET https://artistu.io/api/public/bookings/{artistId}

Authentifiez-vous avec votre jeton dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_TOKEN

Paramètres de requête

Paramètre	Format	Défaut	Description
`startDate`	`YYYY-MM-DD`	aujourd'hui	Première date incluse
`endDate`	`YYYY-MM-DD`	startDate + 1 mois	Dernière date incluse

La plage de dates peut couvrir au maximum 366 jours, et startDate doit être antérieure ou égale à endDate.

Exemple de requête

curl -X GET 'https://artistu.io/api/public/bookings/{artistId}?startDate=2026-08-01&endDate=2026-12-31' \
  --header 'Authorization: Bearer YOUR_API_TOKEN'

Exemple de réponse

{
  "bookings": [
    {
      "bookingId": "uq1ye3nqnb4m5f234auf69gk",
      "artistName": "DJ Example",
      "name": "Summer Festival 2026",
      "date": "2026-08-15T00:00:00.000Z",
      "time": "22:00",
      "duration": 90,
      "venue": "Festival Grounds",
      "capacity": 15000,
      "status": "confirmed",
      "address": {
        "description": "Festival Grounds, Amsterdam, Netherlands",
        "geometry": { "lat": 52.3676, "lng": 4.9041 },
        "components": {
          "city": "Amsterdam",
          "country": "Netherlands",
          "countryCode": "NL"
        }
      },
      "website": "https://summerfestival.example",
      "ticketLink": "https://tickets.example/summer-festival",
      "lineUp": "DJ Example, Support Act",
      "publicNotes": "Main stage closing set"
    }
  ],
  "truncated": false
}

Les réservations sont triées par date croissante. duration est en minutes. status vaut soit option, soit confirmed. Les champs sans valeur sont null.

Une réponse contient au maximum 500 réservations. Si votre plage de dates en contient davantage, truncated vaut true et un champ maxResults est inclus. Réduisez la plage de dates pour récupérer le reste.

Limites de débit

60 requêtes par minute par jeton
120 requêtes par minute par adresse IP

Chaque réponse inclut les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Lorsque vous dépassez une limite, l'API répond avec le statut 429 et vous indique combien de secondes attendre.

Pour un site web classique, mettez la réponse de l'API en cache sur votre propre serveur pendant quelques minutes au lieu d'appeler l'API à chaque affichage de page. Votre page de tournée reste rapide et vous restez loin des limites.

Dépannage

401 Unauthorized : le jeton est manquant, mal formé, ou a été régénéré ou révoqué. Vérifiez l'en-tête Authorization: Bearer et comparez le jeton avec celui dans Paramètres → Intégrations.
404 Artist not found : l'ID d'artiste n'existe pas ou appartient à une autre organisation que celle du jeton.
400 Bad request : une date n'est pas au format YYYY-MM-DD, startDate est postérieure à endDate, ou la plage dépasse 366 jours.
Une réservation manque : vérifiez les trois conditions de visibilité ci-dessus. Le plus souvent, la réservation n'est pas encore annoncée, ou son statut est encore en attente.