Documentazione

Riferimento API

Ottieni un preventivo dello strumento

POST/v1/tools/{id}/quote

Supporta flat (prezzo costante per chiamata), input (precalcolo sugli input) e usage (utilizzo finale). pricing.quote_required determina l'obbligo di preventivo; requires_usage determina l'obbligo di limite di costo e attesa dell'utilizzo finale autorevole; nessuno dei due si deduce da schema_version. Se metered_pricing è disabilitato, sono limitate solo nuove chiamate che richiedono utilizzo finale; regole costanti/input senza tale requisito restano disponibili. La Key corrente deve avere autorizzazione per lo strumento; identità e risultati dell'esecuzione sono vincolati alla Key originale. Se gli strumenti sono globalmente disabilitati, il catalogo è vuoto; quello anonimo non autorizza l'esecuzione. L'id del percorso identifica lo strumento; il corpo pubblico del preventivo accetta solo version obbligatoria non vuota e input conforme a input_schema, rifiutando campi extra come tool_id, quote_id e max_cost_usd. Il preventivo dura 300 secondi, vincolato alla stessa Key, versione esatta, input normalizzati e configurazione prezzi/fonti; restituisce tool_id/version/maximum_usd senza inviare al servizio.

Autenticazione e autorizzazioni

Usa la chiave GloopAPI corrente. Modelli, funzionalità e autorizzazioni disponibili dipendono dal relativo catalogo e dalla documentazione dell'endpoint.

Authorization: Bearer $GLOOP_API_KEY

Schemi di autenticazione: BearerAuth

Richiesta

Parametri del percorso

  • idstringObbligatorio

    ID dello strumento del catalogo o dell'esecuzione originale, secondo l'oggetto dell'operazione.

Corpo della richiesta · application/json

Tipo
object
Campi obbligatori
versioninput
Proprietà aggiuntive
false

Corpo della richiesta obbligatorio

  • versionstringObbligatorio

    Versione del contratto dello strumento obbligatoria e non vuota; usa la version esatta dei dettagli, senza presumere quella corrente.

    Lunghezza minima
    1
    Pattern
    ".*\\S.*"
  • inputunknownObbligatorio

    Deve rispettare input_schema di questa version dello strumento. Solo JSON normalizzato; vietati campi aggiuntivi come route_id amministrativo.

Risposte ed errori

HTTP 200

Preventivo dello strumento ottenuto

application/json

Tipo
object
Campi obbligatori
quote_idmaximum_usdprice_versionexpires_atcomponentstool_idversion
  • quote_idstringObbligatorio

    ID pubblico del preventivo; alla creazione deve rispettare i vincoli di prezzo/richiesta.

  • maximum_usdstringObbligatorio

    Prenotazione massima in dollari per questi input normalizzati.

  • price_versionintegerObbligatorio

    Revisione del prezzo di vendita.

  • expires_atintegerObbligatorio

    Scadenza in secondi Unix; il preventivo dello strumento dura 300 secondi, secondo expires_at effettivo.

  • componentsunknownObbligatorio

    Valore JSON definito dallo schema o protocollo dello strumento scelto; non presumere campi fissi.

  • tool_idstringObbligatorio

    ID dello strumento associato a questo preventivo.

  • versionstringObbligatorio

    Versione esatta del contratto dello strumento associata al preventivo.

HTTP 400

Campi o parametri della richiesta non validi.

application/json

Tipo
object
Campi obbligatori
error

HTTP 401

Key assente, non valida, scaduta o revocata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 403

Autorizzazioni IP, account, modello o strumento insufficienti.

application/json

Tipo
object
Campi obbligatori
error

HTTP 404

Oggetto/funzionalità non disponibile o disabilitata.

application/json

Tipo
object
Campi obbligatori
error

HTTP 409

Conflitto di idempotenza/preventivo, oggetto non pronto o ancora referenziato.

application/json

Tipo
object
Campi obbligatori
error

HTTP 429

Limite di frequenza delle richieste/della coda.

application/json

Tipo
object
Campi obbligatori
error

HTTP 500

Errore interno di autenticazione o storage dei dati.

application/json

Tipo
object
Campi obbligatori
error

HTTP 503

Servizio, prezzi o storage non disponibile.

application/json

Tipo
object
Campi obbligatori
error