Passer au contenu principal

​
Authentification par clé API

Toutes les requêtes API sont authentifiées à l’aide d’une clé API. Générez-en une depuis le tableau de bord Orova et incluez-la dans l’en-tête x-api-key : 
curl https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY"

​
Créer une clé API

1

Connectez-vous au tableau de bord

Rendez-vous sur app.orova.ai et connectez-vous.
2

Accédez à Clés API

Allez dans Settings → API Keys.
3

Créer une clé

Cliquez sur Create API Key et donnez-lui un nom descriptif.
4

Copier la clé

Copiez la clé immédiatement — elle ne s’affiche qu’une seule fois.
Gardez votre clé API secrète. Ne l’exposez pas dans le code côté client (sauf pour l’attribut data-api-key du widget). Utilisez-la uniquement dans les requêtes serveur à serveur.

​
Utilisation de la clé API

Incluez-la dans chaque requête en tant qu’en-tête : 
curl https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY"
Ou dans le widget intégrable : 
<script
  src="https://app.orova.ai/widget/orova-widget.js"
  data-api-key="YOUR_API_KEY"
  ...
></script>

​
Isolation des espaces de travail

Toutes les données sont limitées à un espace de travail. Incluez workspaceId en tant que paramètre de requête ou dans le corps de la requête lorsque nécessaire : 
curl "https://app.orova.ai/api/agents?workspaceId=WORKSPACE_ID" \
  -H "x-api-key: YOUR_API_KEY"