Référence API

Obtenir un devis d'outil

POST/v1/tools/{id}/quote

Prend en charge flat (prix constant par appel), input (précalcul selon l'entrée) et usage (utilisation finale). pricing.quote_required impose ou non un devis ; requires_usage impose ou non un plafond de coût et l'attente de l'utilisation finale faisant autorité ; aucun ne se déduit de schema_version. Si metered_pricing est désactivé, seuls les nouveaux appels nécessitant l'utilisation finale sont limités ; les règles constantes/d'entrée sans cette exigence restent disponibles. La Key actuelle doit être autorisée pour l'outil ; identité d'exécution et résultats sont limités à la Key d'origine. Si l'interrupteur général des outils est désactivé, le catalogue est vide ; le catalogue anonyme ne constitue pas une autorisation d'exécution. L'id du chemin identifie l'outil ; le corps public du devis accepte seulement version obligatoire non vide et input conforme à input_schema, sans champs supplémentaires tool_id, quote_id, max_cost_usd, etc. Le devis dure 300 secondes, lié à la même Key, à la version exacte, aux entrées normalisées et à la configuration des prix/sources ; il renvoie tool_id/version/maximum_usd sans soumission au service.

Authentification et autorisations

Utilisez votre clé GloopAPI actuelle. Les modèles, capacités et autorisations disponibles dépendent de son catalogue et de la documentation du point de terminaison.

Authorization: Bearer $GLOOP_API_KEY

Schémas d'authentification : BearerAuth

Requête

Paramètres de chemin

  • idstringObligatoire

    ID d'outil du catalogue ou ID d'exécution initiale, selon l'objet de l'opération.

Corps de requête · application/json

Type
object
Champs obligatoires
versioninput
Propriétés supplémentaires
false

Corps de requête obligatoire

  • versionstringObligatoire

    Version du contrat d'outil obligatoire et non vide ; utilisez la version exacte des détails, sans valeur courante par défaut.

    Longueur minimale
    1
    Motif
    ".*\\S.*"
  • inputunknownObligatoire

    Doit respecter input_schema de cette version de l'outil. Seul du JSON normalisé est accepté ; champs supplémentaires tels que route_id administrateur interdits.

Réponses et erreurs

HTTP 200

Devis d'outil obtenu

application/json

Type
object
Champs obligatoires
quote_idmaximum_usdprice_versionexpires_atcomponentstool_idversion
  • quote_idstringObligatoire

    ID public du devis ; doit respecter les liens prix/requête à la création.

  • maximum_usdstringObligatoire

    Réservation maximale en dollars pour ces entrées normalisées.

  • price_versionintegerObligatoire

    Révision du prix de vente.

  • expires_atintegerObligatoire

    Expiration en secondes Unix ; le devis outil est valable 300 secondes, selon expires_at réel.

  • componentsunknownObligatoire

    Valeur JSON définie par le schema ou protocole de l'outil choisi ; ne présumez pas de champs fixes.

  • tool_idstringObligatoire

    ID d'outil lié à ce devis.

  • versionstringObligatoire

    Version exacte du contrat d'outil liée à ce devis.

HTTP 400

Champs ou paramètres de requête invalides.

application/json

Type
object
Champs obligatoires
error

HTTP 401

Key absente, invalide, expirée ou révoquée.

application/json

Type
object
Champs obligatoires
error

HTTP 403

Autorisations IP, compte, modèle ou outil insuffisantes.

application/json

Type
object
Champs obligatoires
error

HTTP 404

Objet/capacité indisponible ou fonctionnalité désactivée.

application/json

Type
object
Champs obligatoires
error

HTTP 409

Conflit d'idempotence/devis, objet non prêt ou encore référencé.

application/json

Type
object
Champs obligatoires
error

HTTP 429

Limitation de débit des requêtes/de la file.

application/json

Type
object
Champs obligatoires
error

HTTP 500

Défaillance interne d'authentification ou de stockage des données.

application/json

Type
object
Champs obligatoires
error

HTTP 503

Service, tarification ou stockage indisponible.

application/json

Type
object
Champs obligatoires
error