Aller au contenu principal
API et outils

Authentification avec votre paire de clés

Les appels REST vers https://api.ismalicious.com acceptent X-API-KEY (Base64 de apiKey:apiSecret) ou HTTP Basic (utilisateur apiKey, mot de passe apiSecret). HTTPS obligatoire.

Aucune carte bancaire requise · Clé API gratuite

Requête

Un seul en-tête sur chaque appel protégé.

# X-API-KEY = Base64(apiKey:apiSecret)
curl "https://api.ismalicious.com/check?query=example.com" \
  -H "X-API-KEY: $(echo -n "$API_KEY:$API_SECRET" | base64)"

# Or HTTP Basic Auth
curl -u "$API_KEY:$API_SECRET" \
  "https://api.ismalicious.com/check?query=example.com"

Les anciens clients TAXII peuvent envoyer n’importe quel nom d’utilisateur, avec l’identifiant Base64 comme mot de passe.

StatutSignification
401Identifiants absents ou invalides
403Votre offre n’inclut pas cette route
429Limite de débit dépassée ; voir les en-têtes X-RateLimit-*
Fonctionnalités

L’essentiel en un coup d’œil.

Clés du tableau de bord

Copiez apiKey et apiSecret depuis les paramètres du compte.

Côté serveur uniquement

Stockez les clés en variables d’environnement ou dans un gestionnaire de secrets, jamais côté client ni dans git.

Option session

Les requêtes d’un navigateur connecté peuvent utiliser le cookie de session. Les scripts utilisent X-API-KEY.

FAQ

Questions fréquentes.

Comment authentifier mes requêtes API ?

X-API-KEY : <base64(apiKey:apiSecret)>, ou HTTP Basic avec utilisateur = apiKey et mot de passe = apiSecret. Les deux valeurs se trouvent dans votre tableau de bord.

Comment obtenir une clé API ?

Créez un compte puis ouvrez Compte → Clés API pour consulter ou renouveler vos identifiants. Pas encore de compte ? Un seul curl vers /api/keys/instant renvoie une paire de clés gratuite (voir ci-dessous).

Puis-je obtenir une clé sans créer de compte ?

Oui. Une seule requête crée une paire de clés gratuite : curl -d "email=vous@exemple.com" https://ismalicious.com/api/keys/instant. La réponse contient l’en-tête X-API-KEY prêt à l’emploi, le quota gratuit (250 requêtes/mois, 60/min) et un exemple d’appel ; l’adresse reçoit un lien pour réclamer le compte, définir un mot de passe et renouveler la paire. Limité à 3 clés par jour et par IP. L’outil bootstrap_key du serveur MCP passe par le même chemin.

Pourquoi du Base64 ?

L’API vérifie la paire dans un seul en-tête ; encoder key:secret rend le séparateur non ambigu.

Que faire si ma clé est compromise ?

Renouvelez vos clés depuis le tableau de bord et redéployez immédiatement vos intégrations.

Testez avec vos propres indicateurs.

L’offre gratuite inclut les recherches sur le site sans plafond mensuel et 250 requêtes API par mois. Vérifiez les sources et les limites, puis connectez l’API.

Aucune carte bancaire requise · Clé API gratuite