Aller au contenu

Clés d'API

Les clés d’API autorisent l’accès à l’API et doivent être incluses dans chaque requête. Il existe deux types :

  • Clés d’API payantes (commençant par key_...)
  • Clés d’API gratuites (commençant par ckey_..., où c signifie cryptographique)

Création d’une nouvelle clé d’API

Pour obtenir une clé d’API payante, suivez ces étapes :

  1. Inscrivez-vous sur le site ALTCHA App sur eu.altcha.org pour les clients de l’UE, ou sur us.altcha.org pour les clients aux États-Unis.

  2. Après l’inscription, créez un nouveau projet.

  3. Ouvrez le projet nouvellement créé et accédez aux paramètres du projet :

  4. Cliquez sur “Créer une clé d’API”, définissez un nom et cliquez sur “Enregistrer”.

Configuration des clés d’API

Lors de la création d’une nouvelle clé d’API, vous verrez plusieurs options de configuration :

  • Nom : Un nom personnalisé pour aider à identifier la clé.
  • Secret : Une clé secrète pour la vérification cryptographique, générée de manière aléatoire par défaut.
  • Limite de Taux : Une limite de taux facultative appliquée à toutes les requêtes authentifiées avec cette clé.
  • Domaines Référents : Une liste facultative de noms de domaine autorisés. Entrez un domaine par ligne. Pour les ports non standard, formatez comme <domaine>:8080.
  • Fonctionnalités : Activez des fonctionnalités spécifiques pour cette clé d’API.

Limites de Taux

Vous pouvez configurer des limites de taux personnalisées pour chaque clé d’API, exprimées en requêtes par intervalle (<requêtes>/<intervalle>). Par exemple :

  • 100/120s : Limite à 100 requêtes par 120 secondes.
  • 100/10m : Limite à 100 requêtes par 10 minutes.
  • 10/1h : Limite à 10 requêtes par 1 heure.
  • 10/1d : Limite à 10 requêtes par jour.

Laisser le champ Limite de Taux vide permettra des requêtes illimitées, mais les limites de taux globales seront toujours appliquées.

Fonctionnalités

Chaque clé d’API doit avoir au moins une fonctionnalité sélectionnée. Seules les fonctionnalités sélectionnées seront accessibles avec la clé.