API pour développeurs

Un seul endpoint pour les comparaisons, les questions oui ou non et les scores. Envoyez les faits dont vous disposez et recevez des probabilités, avec une vérification indiquant si ces faits suffisaient.

20 décisions gratuites par clé API et par jour UTC. Sans compte. Utilisez votre clé depuis un serveur, jamais dans du code client public.

Obtenir une clé API

Votre clé

Créez-en une dans ce navigateur. Cloudflare vérifie le navigateur une fois, puis votre serveur envoie la clé comme jeton Bearer. Ask To It ne stocke que son empreinte.

Créer une clé

Deux nouvelles clés par IP et par jour. La clé est liée au pass de ce navigateur, donc les crédits fonctionnent partout : collez-la dans Votre pass sur n’importe quel appareil, utilisez-la dans l’API ou branchez-la sur MCP.

Vérification de votre navigateur…

Faire un appel

Envoyez ceci depuis votre backend. La réponse inclut le temps de traitement mesuré de cet appel et la moyenne API du jour.

POST /v1/decisions

curl https://askto.it/v1/decisions \
  -H "Authorization: Bearer $ASKTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "choice",
    "question": "Should our team build search or use a hosted service?",
    "context": "Two engineers. Launch in three weeks. No search specialist. Budget under $200 a month.",
    "options": ["Build it", "Use a hosted service"]
  }'

Formats de décision

choice accepte de 2 à 6 valeurs distinctes dans options. noul renvoie une probabilité de oui. score accepte trois niveaux ordonnés dans levels.

Lisez le résultat

Chaque réponse réussie inclut signal, result, contextSufficiency et timing.processingMs. Un score de contexte faible appelle davantage de faits.

Stress tests

Définissez "depth":"stress" pour tester la stabilité. Cela coûte 5 crédits de pass. Les analyses standard utilisent d’abord les 20 appels API gratuits, puis 1 crédit chacune.

Serveur MCP pour les agents

Ask To It est un serveur MCP distant. Claude, Cursor, VS Code et d’autres clients MCP peuvent peser des décisions et lancer des stress tests avec la même clé et les mêmes crédits.

Claude Code

claude mcp add --transport http askto https://askto.it/mcp \
  --header "Authorization: Bearer $ASKTO_API_KEY"

Tout client MCP (config JSON)

{
  "mcpServers": {
    "askto": {
      "type": "http",
      "url": "https://askto.it/mcp",
      "headers": { "Authorization": "Bearer askto_api_…" }
    }
  }
}

`weigh_decision`

Comparaison, oui/non ou score. Renvoie la répartition, le signal et la suffisance du contexte. Quota gratuit d’abord, puis 1 crédit.

`stress_test_decision`

Relance avec les options inversées puis chaque fait retiré, et désigne le fait décisif. 5 crédits.

`get_usage`

Appels gratuits restants aujourd’hui et solde du pass associé.

HTTP streamable, sans état, réponses JSON. Prend en charge les versions du protocole de 2026-07-28 à 2025-03-26.

Limites et endpoints

Limites

20 décisions standard gratuites par clé et par jour UTC. Les appels gratuits partagent aussi les plafonds par IP et globaux du site. Une entrée invalide renvoie 400, une clé absente ou révoquée 401, un pass sans crédits 402, et la limite gratuite 429. Les pannes du fournisseur ne consomment pas de crédits.

Autres endpoints

GET /v1/usage: Vos appels gratuits restants et le solde du pass. Clé Bearer requise.
GET /v1/metrics: Moyennes mesurées du jour et nombre d’échantillons. Public.
DELETE /v1/key: Révoque cette clé. Clé Bearer requise.
POST /mcp: Serveur MCP distant. Clé Bearer requise pour les appels d’outils.

Spécification OpenAPI · Tarifs des pass · Confidentialité