Clés d'API gratuites

Les Clés d’API gratuites sont disponibles sans frais, offrant un accès limité à l’API AntiSpam.

Conditions des Clés d’API gratuites:

Limité à 50 requêtes par jour (par domaine)
Assujetti à des limites de fréquence supplémentaires
Attribution requise

Accès Gratuit vs Payant

Passer à des Clés d’API payantes débloque des fonctionnalités supplémentaires telles que l’Analyse et les Journaux de l’API, vous permettant de surveiller l’utilisation de l’API pour vos sites Web et applications.

Fonctionnalité	Gratuit	Payant
Limite de requêtes	50 requêtes/jour	Basée sur le volume acheté
Restrictions de référents	Un référent par clé	Ajustable
Analytiques de l’API	Non	Oui
Journaux de requêtes de l’API	Non	Oui
Attribution requise	Oui	Non

Générer une Clé d’API gratuite

Les Clés d’API gratuites sont liées à un nom de domaine spécifique et fonctionnent uniquement sur les sites Web hébergés sur le nom de domaine fourni.

Générer une clé d'API gratuite

Succès! Créez quelque chose d'incroyable!

Download

Domaine de votre site Web:

Si vous utilisez un numéro de port non standard, saisissez le nom de domaine et le port dans ce format : exemple.com:3000.

Le serveur générera une nouvelle Clé d’API gratuite et un secret :

{
  "hostname": "exemple.com",
  "apiKey": "ckey_49960de...",
  "secret": "csec_55de16dde79f94...",
  "licence": "...",
  "vérification": {
    "DNS": {
      "nom": "@",
      "type": "TXT",
      "valeur": "altcha-verification=..."
    }
  }
}

Le secret csec_... est utilisé pour la vérification de la charge utile (en tant que secret HMAC) et doit rester confidentiel, jamais exposé publiquement.

Consultez la documentation pour apprendre comment générer une nouvelle Clé d’API en utilisant l’API.

Vérification du Domaine

Bien que facultative, la vérification du domaine est fortement recommandée. En vérifiant la propriété de votre nom de domaine via l’enregistrement DNS TXT configuré avec la valeur altcha-verification=... fournie, vous ajoutez une couche de sécurité supplémentaire.

La vérification du domaine garantit que votre Clé d’API est associée de manière appropriée au nom de domaine avec lequel elle est censée fonctionner.

Pour vérifier votre nom de domaine, suivez ces étapes :

Accédez à votre panneau de gestion des enregistrements DNS.
Ajoutez un enregistrement TXT avec les détails suivants :
- Type d’enregistrement : TXT
- Hôte/Nom : @ (ou votre nom de domaine)
- Valeur/Texte : altcha-verification=abc... (remplacez abc... par votre jeton de vérification unique obtenu lors de la génération de la Clé d’API)
Enregistrez les modifications.

Une fois que l’enregistrement DNS est ajouté et propagé avec succès, la propriété du domaine sera vérifiée. Cela garantit l’utilisation sécurisée de votre Clé d’API avec le nom de domaine spécifié.

Attribution pour les Clés d’API gratuites

Lors de l’utilisation de la Clé d’API gratuite, vous DEVEZ afficher “Protégé par ALTCHA” avec le logo dans le widget (c’est-à-dire ne pas utiliser hidelogo ou hidefooter). Si vous n’utilisez pas le widget, vous DEVEZ inclure une attribution dans le pied de page de votre site Web, au moins sur la page d’accueil :

<a href="https://altcha.org">Protégé par ALTCHA</a>

Vous pouvez traduire ou modifier le texte, mais il doit transmettre un sens similaire à “Protégé par ALTCHA”. Le lien doit diriger vers https://altcha.org et ne doit pas inclure rel="nofollow".