Documentación

Referencia de API

Obtener ejecución de herramienta

GET/v1/tool-runs/{id}

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.

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.

Respuestas y errores

HTTP 200

Ejecución de herramienta obtenida correctamente

application/json

Tipo
object
Campos obligatorios
idtool_idversionstatusoutputbillingresult_expiredcreated_atupdated_at
  • idstringObligatorio

    Identificador público del objeto, usado en su ruta de detalles.

  • tool_idstringObligatorio

    ID de herramienta del catálogo ejecutable de la clave actual.

  • versionstringObligatorio

    Versión de contrato/capacidad o herramienta; la ejecución usa la versión del catálogo.

  • statusstringObligatorio

    submitting/running/submission_unknown/succeeded/failed; submission_unknown indica resultado de envío desconocido. No reenvíes con otro Idempotency-Key.

  • outputunknownObligatorio

    JSON definido por output_schema de la herramienta; no supongas que sigue existiendo tras caducar.

  • error_codestringOpcional

    Código público de error para decisiones de flujo.

  • billingobjectObligatorio

    Estado de facturación independiente, no sustituible por estado de generación.

    Campos secundarios de billing (7)
    • review_requiredbooleanOpcional

      Las pruebas de facturación requieren revisión manual.

    • reasonstringOpcional

      Motivo público de acción no disponible o revisión de facturación.

    • usageunknownOpcional

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

    • breakdownunknownOpcional

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

    • statusstringObligatorio

      Estado actual del objeto; evalúalo aparte de facturación y guardado.

    • reserved_usdstringObligatorio

      Reserva máxima en USD como cadena.

    • charged_usdstringObligatorio

      Importe en USD confirmado actualmente, como cadena.

    Rama allOf 1

    Tipo: object

    Obligatorio en esta rama: status, reserved_usd, charged_usd

    • review_requiredbooleanOpcional

      Las pruebas de facturación requieren revisión manual.

    • reasonstringOpcional

      Motivo público de acción no disponible o revisión de facturación.

    • usageunknownOpcional

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

    • breakdownunknownOpcional

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

    • statusstringObligatorio

      Estado actual del objeto; evalúalo aparte de facturación y guardado.

    • reserved_usdstringObligatorio

      Reserva máxima en USD como cadena.

    • charged_usdstringObligatorio

      Importe en USD confirmado actualmente, como cadena.

  • result_expiredbooleanObligatorio

    Si el resultado caducó; facturación e idempotencia se conservan.

  • created_atintegerObligatorio

    Fecha de creación en segundos Unix.

  • updated_atintegerObligatorio

    Última actualización en segundos Unix.

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