Aperçu de l'API
API publique Sway
L'API publique Sway permet à un crew (une agence d'artistes ou un collectif de promoteurs) d'intégrer ses données Sway sur des sites web externes — roster, événements, salles, catégories de billets — et de recevoir des demandes de booking envoyées depuis ces sites. Elle est conçue pour les sites partenaires : le site de votre agence reste totalement indépendant et ne communique avec Sway qu'à travers l'API.
L'API est en lecture seule, à l'exception d'un seul endpoint : POST /v1/booking-requests.
URL de base
https://www.sway.events/api/v1
Tous les endpoints sont versionnés sous /v1. Les réponses sont en JSON avec des clés en snake_case.
Qui a accès
L'accès à l'API est inclus dans les formules Studio et Roster.
Les clés API se créent depuis l'admin du crew : Admin crew → API. Chaque clé appartient à exactement un crew — c'est la clé seule qui détermine quelles données vous voyez, jamais un paramètre de requête. Si l'abonnement du crew expire, ses clés cessent de fonctionner jusqu'à la réactivation de l'abonnement.
Les deux niveaux de visibilité
Chaque ressource accessible via l'API est soit gérée (managed), soit publique :
| Niveau | Ce qu'il couvre | Ce que vous obtenez |
|---|---|---|
| Gérée (managed) | Les pages liées à votre crew (vos artistes, vos promoteurs) et leurs événements | Représentation complète — bio, tous les liens externes y compris les emails de contact, historique des dates |
| Publique (étrangère) | Les ressources présentes dans vos événements mais non gérées par votre crew — artistes invités au lineup, salles | Représentation publique réduite : uniquement ce que la page publique Sway affiche déjà. Marquée "managed": false |
Exemple — l'invité du lineup. L'événement de votre promoteur programme un artiste invité qui ne fait pas partie de votre crew. Cet artiste apparaît directement dans le lineup de l'événement avec les champs publics uniquement (nom, image, genres) et "managed": false. Vous ne pouvez pas le récupérer directement : GET /v1/artists/{id} pour un artiste étranger renvoie 404.
Tout ce qui se trouve en dehors du graphe de votre crew renvoie également 404 — jamais 403 — l'API ne révèle donc rien sur les ressources auxquelles vous n'avez pas accès.
Démarrage rapide
Vérifiez votre clé et ses capacités avec l'endpoint d'introspection :
curl https://www.sway.events/api/v1/me \
-H "Authorization: Bearer sway_sk_VOTRE_CLE"
{
"key": {
"id": "3f9a1c02-7b45-4c8e-9d21-0a1b2c3d4e5f",
"scopes": ["read:profile", "read:artists", "read:promoters", "read:events", "read:venues"],
"rate_limit": { "per_minute": 120, "per_day": 20000 }
},
"crew": { "id": "a2628d53-4f21-4c1e-9b7d-1a2b3c4d5e6f", "name": "Insomnia", "slug": "insomnia" }
}
La réponse est l'objet lui-même — les endpoints de ressource unique ne sont pas enveloppés dans un objet data (seuls les endpoints de liste le sont).