Documentación

Referencia de API

Obtener cotización de herramienta

POST/v1/tools/{id}/quote

Admite flat constante por llamada, input precalculado por entradas y usage según uso final. pricing.quote_required determina si se exige cotización; requires_usage, si se exige límite de coste y uso final confirmado. Ninguno se deduce de schema_version. Con metered_pricing apagado solo se restringen llamadas nuevas que requieren uso final; reglas constantes/por entrada sin ese requisito siguen disponibles. La clave actual necesita autorización de herramientas; identidad y resultados quedan limitados a la clave original. Con el interruptor general apagado el catálogo está vacío; el catálogo anónimo no autoriza la ejecución. id de ruta identifica la herramienta; el cuerpo público solo acepta version obligatorio no vacío e input conforme a input_schema. Rechaza campos extra como tool_id, quote_id y max_cost_usd. Cotización válida 300 segundos, vinculada a misma clave, versión exacta, entrada normalizada y configuración de precio/origen; devuelve tool_id/version/maximum_usd y no envía al servicio.

Autenticación y permisos

Usa tu clave actual de GloopAPI. Los modelos, capacidades y permisos dependen de su catálogo y de la documentación del endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticación: BearerAuth

Solicitud

Parámetros de ruta

  • idstringObligatorio

    ID de herramienta del catálogo o ejecución original, según objeto de la operación.

Cuerpo de solicitud · application/json

Tipo
object
Campos obligatorios
versioninput
Propiedades adicionales
false

Cuerpo de solicitud obligatorio

  • versionstringObligatorio

    Versión de contrato obligatoria no vacía; usa version exacta de los detalles, no se usa la actual por defecto.

    Longitud mínima
    1
    Patrón
    ".*\\S.*"
  • inputunknownObligatorio

    Debe cumplir input_schema de esa version; solo JSON normalizado, sin campos adicionales como route_id de administrador.

Respuestas y errores

HTTP 200

Cotización de herramienta obtenida correctamente

application/json

Tipo
object
Campos obligatorios
quote_idmaximum_usdprice_versionexpires_atcomponentstool_idversion
  • quote_idstringObligatorio

    ID público de cotización; debe coincidir con precio y solicitud al crear.

  • maximum_usdstringObligatorio

    Reserva máxima en USD para esta entrada normalizada.

  • price_versionintegerObligatorio

    Revisión del precio de venta.

  • expires_atintegerObligatorio

    Caducidad en segundos Unix; las cotizaciones de herramientas duran 300 segundos, según expires_at real.

  • componentsunknownObligatorio

    Valor JSON definido por esquema o protocolo de la herramienta; sin campos fijos supuestos.

  • tool_idstringObligatorio

    ID de herramienta vinculado a esta cotización.

  • versionstringObligatorio

    Versión exacta de contrato vinculada a esta cotización.

HTTP 400

Campos o parámetros de solicitud inválidos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 401

La clave falta, no es válida, caducó o fue revocada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

Permisos insuficientes de IP, cuenta, modelo o herramienta.

application/json

Tipo
object
Campos obligatorios
error

HTTP 404

Objeto/capacidad no disponible o función desactivada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 409

Conflicto de idempotencia/cotización, objeto no preparado o aún referenciado.

application/json

Tipo
object
Campos obligatorios
error

HTTP 429

Límite de solicitudes/cola.

application/json

Tipo
object
Campos obligatorios
error

HTTP 500

Fallo interno de autenticación o almacenamiento de datos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 503

Servicio, precios o almacenamiento no disponibles.

application/json

Tipo
object
Campos obligatorios
error