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 :
-
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.
-
Après l’inscription, créez un nouveau projet.
-
Ouvrez le projet nouvellement créé et accédez aux paramètres du projet :
-
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é.
- API des Formulaires : Accord un accès à la gestion des formulaires.
- API AntiSpam : Accord un accès à l’API de Défi PoW et à l’API de Filtre Anti-Spam.