Authentification

SayMyData offre une Clé API permettant d'autoriser et sécuriser vos requêtes API. Chaque organisation peut générer plusieurs clés pour gérer différents accès et usages.

Génération d'une Clé API

Pour créer une clé API, suivez ces étapes dans le tableau de bord SayMyData :

1. Connexion au Tableau de Bord : Connectez-vous à votre compte sur le tableau de bord SayMyData avec vos identifiants.

2. Accéder aux Clés API : Dans le menu latéral gauche, cliquez sur Intégration.

3. Créer une Nouvelle Clé API : Cliquez sur "Créer une clé API" pour en générer une nouvelle. Vous pourrez alors indiquer :

   1. Le nom de la Clé API

   2. Le rôle de la Clé API qui détermine les permissions qui y sont associées :

      1. Lecture : Questionner les données

      2. Modification : Permet également de créer et supprimer des ressources, ajouter et supprimer des sources de données.

      3. Admin : Permet également de créer, supprimer, modifier des Bases de connaissances et d'en gérer les accès.

4. Copier la Clé API : Une fois la clé générée, vous pouvez la copier pour l’utiliser dans vos requêtes.

Utilisation de la Clé API

Pour accéder à vos Bases de connaissances et vos Ressources depuis un système extérieur ou un Datastore, vous devez inclure la clé API SayMyData dans l'en-tête de chaque requête.

Exemple d'en-tête d'authentification :

GET /some-endpoint HTTP/1.1
Host: api.saymydata.com
X-API-Key: <VOTRE_CLÉ_API>

Points à retenir :

• Sécurité : Ne partagez jamais votre clé API en public ou dans des environnements non sécurisés.

• Gestion : Vous pouvez révoquer ou générer de nouvelles clés API à tout moment depuis votre tableau de bord.

• Limites : Assurez-vous de respecter les quotas d'usage définis dans votre abonnement.