Clés API – créer et gérer

Une clé API est une clé d’accès numérique. Elle permet à des applications externes d’accéder de manière sécurisée à certaines données de ton compte Eventfrog, par exemple pour mettre à jour automatiquement des événements ou connecter différents systèmes. Tu décides toi-même si tu utilises une clé, quelles autorisations elle possède et combien de temps elle reste valable.

Aperçu :

Où trouver les clés API ?

La gestion de tes clés API se trouve dans ton compte client, sous « Paramètres » puis « Clés API ». La liste affiche toutes les clés API que tu as créées – y compris le nom, le type de clé, la durée de validité et la date de la dernière utilisation. Tu peux modifier les clés existantes tant qu’elles n’ont pas encore atteint leur durée maximale de validité, et ajuster le libellé affiché ou la date d’expiration.

Tu peux donc :

créer des clés
consulter les clés existantes
vérifier les dates d’expiration
modifier les libellés
copier la clé

Un lien vers la documentation technique de l’API est visible à tout moment sur cette page. Pour des raisons de sécurité, la clé elle-même n’est jamais affichée en clair. Ce n’est qu’en cliquant explicitement sur « Afficher la clé API » qu’elle apparaît dans une fenêtre sécurisée et peut être copiée depuis cet endroit.

Créer une clé API

Lors du processus de création, tu choisis d’abord le type de clé. Selon l’utilisation prévue, la clé peut donner un accès en lecture seule ou autoriser en plus la modification et la suppression de tes données d’événement. Tu peux ajouter un libellé de manière facultative afin de reconnaître plus facilement à quoi la clé est destinée par la suite. Enfin, tu définis la date de validité et crées la clé en un clic. Elle apparaît immédiatement dans la liste.

Voici comment procéder :

Cliquer sur « Créer une clé API »
Sélectionner le type de clé (par ex. lecture seule ou modification/suppression)
Saisir un libellé (facultatif)
Définir la date de validité
Confirmer l’opération

Aperçu des types de clés

Il existe trois types de clés : la clé API publique pour la lecture des données d’événements publics, la clé API organisateur avec accès en lecture seule, ainsi que la clé API organisateur avec droits de lecture, d’écriture et de suppression. Il existe également une clé dite « embed », générée automatiquement dès que tu intègres la billetterie Eventfrog. Celle-ci n’apparaît pas dans l’aperçu et ne peut pas être utilisée pour des requêtes API.

Chaque clé API expire automatiquement à la date définie. Nous t’informons au préalable par e-mail – 14 jours, 7 jours et 1 jour avant l’expiration. Ces rappels contiennent le nom et le type de la clé ainsi qu’un lien vers sa gestion. Pour des raisons de sécurité, la clé elle-même n’est jamais envoyée par e-mail. Après expiration, une clé reste visible pendant encore douze mois, mais ne peut plus être utilisée ni modifiée. Elle est ensuite automatiquement masquée.

Partager une clé avec des tiers

Si tu souhaites donner accès à des personnes externes, tu peux créer toi-même une clé API appropriée et la transmettre. Les clés organisateur s’appliquent toujours exclusivement aux événements que tu as créés. Par exemple, si une agence doit consulter des données ou gérer du contenu, tu définis les droits d’accès via la clé.

Afin d’éviter tout abus, des limites automatiques s’appliquent à l’utilisation des clés. Par compte utilisateur, un maximum de 30 requêtes par minute et 2 000 requêtes par jour est autorisé – quel que soit le nombre de clés API existantes. Tous les accès sont enregistrés et surveillés d’un point de vue technique.

Clés API existantes

Si tu utilisais déjà des clés API auparavant, elles ont été reprises automatiquement. Les clés utilisées uniquement pour l’intégration de la billetterie ont reçu le type « Embed ». Les clés qui interrogeaient des données d’événements via l’API ont été classées comme « Public API ». Si une clé remplissait auparavant les deux fonctions, nous créons une nouvelle clé pour l’usage public et t’en informons.

URL technique

Les API Eventfrog sont accessibles à l’adresse :

api.eventfrog.net