API per sviluppatori

Un solo endpoint per confronti, sì o no e punteggi. Invia i fatti che hai e ricevi probabilità, compresa una verifica sulla sufficienza dei fatti.

20 decisioni gratis per chiave API ogni giorno UTC. Nessun account. Usa la chiave da un server, mai nel codice client pubblico.

Ottieni una chiave API

La tua chiave

Creala in questo browser. Cloudflare verifica il browser una volta, poi il tuo server invia la chiave come token Bearer. Ask To It conserva solo la sua impronta.

Crea una chiave

Due nuove chiavi per IP al giorno. La chiave è collegata al pass di questo browser, quindi i crediti valgono ovunque: incollala in Il tuo pass su qualsiasi dispositivo, usala nell’API o collegala a MCP.

Verifica del browser in corso…

Fai una chiamata

Inviala dal tuo backend. La risposta include il tempo di elaborazione misurato di questa chiamata e la media API di oggi.

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"]
  }'

Formati di decisione

choice accetta da 2 a 6 options. noul restituisce una probabilità di sì. score accetta tre levels.

Leggi il risultato

Ogni risposta riuscita include signal, result, contextSufficiency, e timing.processingMs. Un punteggio di contesto basso chiede più fatti.

Stress test

Imposta "depth":"stress" per verificare la stabilità. Costa 5 crediti del pass. Le valutazioni standard usano prima le 20 chiamate API gratuite, poi 1 credito ciascuna.

Server MCP per agenti

Ask To It è un server MCP remoto. Claude, Cursor, VS Code e altri client MCP possono valutare decisioni ed eseguire stress test con la stessa chiave e gli stessi crediti.

Claude Code
claude mcp add --transport http askto https://askto.it/mcp \
  --header "Authorization: Bearer $ASKTO_API_KEY"
Qualsiasi client MCP (configurazione JSON)
{
  "mcpServers": {
    "askto": {
      "type": "http",
      "url": "https://askto.it/mcp",
      "headers": { "Authorization": "Bearer askto_api_…" }
    }
  }
}

weigh_decision

Confronto, sì/no o punteggio. Restituisce la distribuzione, il segnale e la sufficienza del contesto. Prima la quota gratuita, poi 1 credito.

stress_test_decision

Ripete con le opzioni invertite e togliendo un fatto alla volta, poi indica il fatto decisivo. 5 crediti.

get_usage

Chiamate gratuite rimaste oggi e saldo del pass collegato.

HTTP in streaming, senza stato, risposte JSON. Supporta le versioni del protocollo dalla 2026-07-28 fino alla 2025-03-26.

Limiti ed endpoint

Limiti

20 decisioni standard gratuite per chiave per giorno UTC. Le chiamate gratuite condividono anche i limiti per IP e globali del sito. Un input non valido restituisce 400, chiavi mancanti o revocate 401, crediti del pass esauriti 402 e il limite gratuito 429. Gli errori del fornitore non consumano crediti del pass.

Altri endpoint

GET /v1/usage
Le chiamate gratuite rimaste e il saldo del pass. Richiede la chiave Bearer.
GET /v1/metrics
Medie misurate di oggi e numero di campioni. Pubblico.
DELETE /v1/key
Revoca questa chiave. Richiede la chiave Bearer.
POST /mcp
Server MCP remoto. Richiede la chiave Bearer per le chiamate agli strumenti.