Référence API
Obtenir un devis d'outil
/v1/tools/{id}/quotePrend 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_KEYSchémas d'authentification : BearerAuth
Requête
Paramètres de chemin
idstringObligatoireID 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
versionstringObligatoireVersion 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.*"
inputunknownObligatoireDoit 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_idstringObligatoireID public du devis ; doit respecter les liens prix/requête à la création.
maximum_usdstringObligatoireRéservation maximale en dollars pour ces entrées normalisées.
price_versionintegerObligatoireRévision du prix de vente.
expires_atintegerObligatoireExpiration en secondes Unix ; le devis outil est valable 300 secondes, selon expires_at réel.
componentsunknownObligatoireValeur JSON définie par le schema ou protocole de l'outil choisi ; ne présumez pas de champs fixes.
tool_idstringObligatoireID d'outil lié à ce devis.
versionstringObligatoireVersion 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
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 401
Key absente, invalide, expirée ou révoquée.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 403
Autorisations IP, compte, modèle ou outil insuffisantes.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 404
Objet/capacité indisponible ou fonctionnalité désactivée.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 409
Conflit d'idempotence/devis, objet non prêt ou encore référencé.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 429
Limitation de débit des requêtes/de la file.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 500
Défaillance interne d'authentification ou de stockage des données.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 503
Service, tarification ou stockage indisponible.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif