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, classificare lotti, ordinare opzioni e verificare azioni 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.

`triage_batch`

Assegna un punteggio da 1 a 100 elementi sugli stessi tre livelli, ad esempio urgenza bassa, media e alta, e li ordina per il livello più alto. 1 chiamata per elemento.

`rank_options`

Ordina da 2 a 20 opzioni, ciascuna con un punteggio. 1 chiamata fino a 6 opzioni, al massimo 5 chiamate per 20.

`criteria_matrix`

Assegna un punteggio da 2 a 6 opzioni su 2 a 6 criteri ponderati e somma una classifica ponderata. 1 chiamata per criterio.

`check_before_acting`

Valuta se procedere o attendere prima che un agente agisca, con un controllo con la domanda invertita. È un giudizio del modello e non offre alcuna garanzia di sicurezza. 2 chiamate.

`get_usage`

Chiamate gratuite rimaste oggi e saldo del pass collegato.

Ogni chiamata usa prima la quota giornaliera gratuita della chiave, poi 1 credito del pass. Quando i crediti finiscono, il risultato dello strumento include un link di ricarica per il pass di quella chiave.

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 di fatturazione includono un topUpUrl che aggiunge crediti al pass della chiave. 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 /v1/triage: Assegna un punteggio fino a 100 elementi su tre livelli. 1 chiamata per elemento.
POST /v1/rank: Ordina da 2 a 20 opzioni. Da 1 a 5 chiamate.
POST /v1/matrix: Opzioni confrontate con criteri ponderati. 1 chiamata per criterio.
POST /v1/check: Procedere o attendere prima di un’azione. 2 chiamate.
POST /mcp: Server MCP remoto. Richiede la chiave Bearer per le chiamate agli strumenti.

Specifica OpenAPI · Prezzi dei pass · Privacy