API Développeur

Toutes les requêtes API nécessitent une clé API passée dans le header X-Checkwise-API-Key.

curl https://developer.checkwise.ai/v1/check \
  -H "X-Checkwise-API-Key: sk_test_xxxxxxxxxxxxxxxxxxxx"

Pour obtenir une clé API, contactez-nous ou créez-en une depuis votre tableau de bord.

URL de base : https://developer.checkwise.ai

POST /v1/check

Soumettez une affirmation pour vérification. L'API accepte du texte, une URL, ou une image encodée en base64 et retourne un verdict structuré avec les sources.

Requête

curl -X POST https://developer.checkwise.ai/v1/check \
  -H "Content-Type: application/json" \
  -H "X-Checkwise-API-Key: YOUR_API_KEY_HERE" \
  -d '{
    "text": "Le SMIC en France a atteint 1766,92 euros brut par mois en janvier 2024"
  }'

curl -X POST https://developer.checkwise.ai/v1/check \
  -H "Content-Type: application/json" \
  -H "X-Checkwise-API-Key: YOUR_API_KEY_HERE" \
  -d '{
    "url": "https://www.example.com/article"
  }'

curl -X POST https://developer.checkwise.ai/v1/check \
  -H "Content-Type: application/json" \
  -H "X-Checkwise-API-Key: YOUR_API_KEY_HERE" \
  -d '{
    "image": "iVBORw0KGgoAAAANS..."
  }'

Corps de la requête, fournir l'un des champs suivants :

• text (string) : l'affirmation à vérifier.
• url (string) : URL d'un article à vérifier.
• image (string) : image encodée en base64 contenant une affirmation.

Réponse

{
  "ok": true,
  "report_code": "76W3FC",
  "global_score": 100,
  "global_verdict": "true",
  "synthesis": "Les sources officielles confirment unanimement que le SMIC brut mensuel a été fixé à 1 766,92 € au 1er janvier 2024.",
  "claims": [
    {
      "id": "c1",
      "text": "Le SMIC en France a atteint 1766,92 euros brut par mois en janvier 2024",
      "category": "economic",
      "verdict": "true",
      "score": 100,
      "sources_kept": [
        {
          "url": "https://www.service-public.fr/...",
          "organization": "Service-Public.fr",
          "summary": "Le SMIC brut mensuel a été fixé à 1 766,92 € au 1er janvier 2024.",
          "verdict": "true",
          "site_rating": 93,
          "biases": []
        },
        {
          "url": "https://www.insee.fr/...",
          "organization": "INSEE",
          "summary": "SMIC mensuel brut : 1 766,92 € au 1er janvier 2024.",
          "verdict": "true",
          "site_rating": 91,
          "biases": []
        },
        {
          "url": "https://www.legifrance.gouv.fr/...",
          "organization": "Légifrance",
          "summary": "Le décret n° 2023-1216 fixe le SMIC à 1 766,92 € brut mensuel.",
          "verdict": "true",
          "site_rating": 95,
          "biases": []
        }
      ]
    }
  ],
  "processing_time_ms": 28450,
  "metadata": {
    "total_sources": 3,
    "input_type": "text"
  }
}

Champs clés de la réponse

• global_score (0–100%) : score de solidité des preuves, normalisé en pourcentage : MAX(ROUND(raw / max × 100) − pénalités, 0). 3 sources TRUE sur 3 = 100%.
• global_verdict : verdict global : "true", "false", "mixed" ou "not_rated".
• claims[].verdict : verdict par affirmation. Déterminé par le consensus des sources : ≥80% TRUE → "true", ≥80% FALSE → "false", sinon → "mixed". Une seule source donne toujours "mixed".
• claims[].sources_kept : sources utilisées, chacune avec son verdict, summary et site_rating (score de crédibilité ou "source not verified yet").
• synthesis : résumé lisible de l'analyse.
• report_code : code unique pour retrouver ou partager le rapport.

POST /v1/rate-site

Évaluez la crédibilité, les biais et la fiabilité de n'importe quel site web. Vous pouvez passer une URL complète ou juste un domaine, l'API normalise automatiquement.

Requête

curl -X POST https://developer.checkwise.ai/v1/rate-site \
  -H "Content-Type: application/json" \
  -H "X-Checkwise-API-Key: YOUR_API_KEY_HERE" \
  -d '{
    "url": "https://www.lemonde.fr"
  }'

Corps de la requête

• url (string) : n'importe quelle URL (page d'accueil, article, etc.). Le domaine est extrait automatiquement.
• domain (string) : alternativement, passez le domaine directement (ex. "lemonde.fr").

Réponse

{
  "ok": true,
  "domain": "lemonde.fr",
  "name": "Le Monde",
  "overall_score": 92,
  "verdict": "Source très crédible avec une excellente transparence...",
  "categories": ["general", "politics", "society", "breaking_news"],
  "country": "FR",
  "region": "Europe",
  "language": "fr",
  "type": "media",
  "flags": ["trusted", "peer_reviewed", "fact_checker"]
}

Champs clés de la réponse

• overall_score (0–100) : score de crédibilité global.
• verdict : évaluation lisible de la crédibilité.
• categories : catégories de contenu du site.
• flags : indicateurs de crédibilité : "trusted", "peer_reviewed", "fact_checker", "partisan", "limited_data", etc.
• country, region, language, type : métadonnées du site.

Les scores détaillés par critère (10 dimensions) et les analyses par critère sont disponibles sur les plans API supérieurs. Contactez-nous pour en savoir plus.

POST /v1/image-analysis

Analysez une image pour déterminer si elle a été générée par IA (Midjourney, DALL-E, Stable Diffusion, Flux, Firefly, etc.). Utilise un ensemble de 4 modèles avec un scoring pondéré par fiabilité. Retourne le verdict, le score de confiance, l'identification du générateur, la heatmap et une explication détaillée.

Requête

curl https://developer.checkwise.ai/v1/image-analysis \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer org_xxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "image_base64": "<image encodée en base64>"
  }'

Corps de la requête

• image_base64 (string, requis) : image encodée en base64 (JPEG, PNG, WebP).
• url (string, optionnel) : URL de l'image à analyser. Utilisé si image_base64 n'est pas fourni.

Réponse

{
  "success": true,
  "verdict": "likely_ai",
  "ai_score": 62.2,
  "is_ai": true,
  "confidence": 62.2,
  "explanation": "Cette image a très probablement été générée par Stable Diffusion ou un outil similaire...",
  "generator": "Stable Diffusion",
  "heatmap_url": "data:image/jpeg;base64,..."
}

Verdicts

• ai_generated : très haute confiance IA (score ≥ 80)
• likely_ai : haute confiance IA (score ≥ 55)
• uncertain : non concluant (score 35–55)
• likely_real : probablement authentique (score 15–35)
• authentic : haute confiance authentique (score < 15)

Note : La première requête peut prendre jusqu'à 60 secondes (démarrage à froid). Les requêtes suivantes s'exécutent en ~1–2 secondes.

L'API utilise les codes de statut HTTP standards :

• 200 : succès. Le corps de la réponse contient le résultat.
• 400 : requête invalide. Paramètres manquants ou invalides.
• 401 : non autorisé. Clé API invalide ou manquante.
• 429 : limite de requêtes dépassée.
• 500 : erreur interne du serveur.

Format de réponse d'erreur

{
  "ok": false,
  "error": "VALIDATION_ERROR",
  "message": "Au moins un des champs text, url ou image_base64 doit être fourni"
}

Les limites de requêtes dépendent de votre plan :

• Gratuit : ---
• Starter : ---
• Pro : ---
• Enterprise : ---

Les headers de limite de requêtes sont inclus dans chaque réponse :

X-RateLimit-Limit: ---
X-RateLimit-Remaining: ---
X-RateLimit-Reset: ---

Lorsque vous dépassez la limite, vous recevrez une réponse 429. Contactez-nous pour upgrader votre plan.