Retour à la documentation

Authentification

Apprenez comment vous authentifier avec l'API Arkangel AI en utilisant des clés API

par Arkangel AI Team•1 min de lecture

L'API Arkangel AI utilise des clés API pour authentifier les requêtes. Vous pouvez voir et gérer vos clés API dans le tableau de bord de votre compte.

Obtenir Votre Clé API

  1. Connectez-vous à votre compte Arkangel AI
  2. Allez dans Paramètres > API
  3. Cliquez sur Générer une Nouvelle Clé API
  4. Copiez et stockez votre clé en toute sécurité

Important : Votre clé API est secrète. Ne la partagez pas et ne l'exposez pas dans le code côté client.

Utiliser Votre Clé API

Incluez votre clé API dans l'en-tête Authorization de toutes les requêtes :

curl -X POST https://api.arkangelai.com/v1/chat \
  -H "Authorization: Bearer votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"message": "Bonjour"}'

Exemple JavaScript

const response = await fetch('https://api.arkangelai.com/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer votre_cle_api',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Bonjour'
  })
});

Exemple Python

import requests

headers = {
    'Authorization': 'Bearer votre_cle_api',
    'Content-Type': 'application/json'
}

response = requests.post(
    'https://api.arkangelai.com/v1/chat',
    headers=headers,
    json={'message': 'Bonjour'}
)

Sécurité des Clés API

  • N'exposez jamais votre clé API dans le code côté client
  • Utilisez des variables d'environnement pour stocker vos clés
  • Effectuez une rotation de vos clés régulièrement
  • Révoquez immédiatement toute clé compromise

Variables d'Environnement

# .env
ARKANGEL_API_KEY=votre_cle_api

// Utiliser la variable d'environnement
const apiKey = process.env.ARKANGEL_API_KEY;

Erreurs d'Authentification

Code Message Description
401 invalid_api_key La clé API fournie n'est pas valide
401 missing_api_key Aucune clé API n'a été fournie
403 api_key_revoked La clé API a été révoquée
429 rate_limit_exceeded Vous avez dépassé la limite de requêtes

Prochaines Étapes