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, trier des lots, classer des options et vérifier des actions 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.

`triage_batch`

Note de 1 à 100 éléments sur les trois mêmes niveaux, par exemple urgence faible, moyenne et élevée, et les trie par niveau le plus haut. 1 appel par élément.

`rank_options`

Classe de 2 à 20 options, chacune avec un score. 1 appel jusqu’à 6 options, au maximum 5 appels pour 20.

`criteria_matrix`

Note de 2 à 6 options sur 2 à 6 critères pondérés et additionne un classement pondéré. 1 appel par critère.

`check_before_acting`

Pèse continuer ou attendre avant qu’un agent agisse, avec un contrôle par question inversée. C’est un jugement du modèle qui ne garantit aucune sécurité. 2 appels.

`get_usage`

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

Chaque appel utilise d’abord le quota gratuit quotidien de la clé, puis 1 crédit de pass. Quand les crédits sont épuisés, le résultat de l’outil inclut un lien de recharge pour le pass de cette clé.

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 erreurs de facturation incluent un topUpUrl qui ajoute des crédits au pass de la clé. 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 /v1/triage: Note jusqu’à 100 éléments sur trois niveaux. 1 appel par élément.
POST /v1/rank: Classe de 2 à 20 options. 1 à 5 appels.
POST /v1/matrix: Options face à des critères pondérés. 1 appel par critère.
POST /v1/check: Continuer ou attendre avant une action. 2 appels.
POST /mcp: Serveur MCP distant. Clé Bearer requise pour les appels d’outils.

Spécification OpenAPI · Tarifs des pass · Confidentialité