التوثيق

مرجع API

الحصول على عرض سعر أداة

POST/v1/tools/{id}/quote

دعم موحّد لتسعير flat الثابت لكل استدعاء، وتسعير input المحسوب مسبقًا من المدخلات، وتسعير usage المبني على الاستخدام النهائي. يحدد pricing.quote_required إلزامية عرض السعر؛ ويحدد requires_usage الحاجة إلى سقف تكلفة واستخدام نهائي موثوق. لا يُستنتج أي منهما من schema_version. عند تعطيل metered_pricing، تُقيّد الاستدعاءات الجديدة التي تتطلب الاستخدام النهائي فقط؛ وتظل القواعد الثابتة/المبنية على المدخلات متاحة إن لم تحتج إلى استخدام نهائي. يجب أن يملك المفتاح الحالي صلاحية الأداة؛ وترتبط هوية التشغيل ونتائجه بالمفتاح الأصلي. يكون الدليل فارغًا عند تعطيل المفتاح الرئيسي للأدوات؛ ولا يمنح الدليل المجهول صلاحية التنفيذ. يحدد id في المسار هوية الأداة. لا يقبل جسم عرض السعر العام إلا version مطلوبًا غير فارغ وinput مطابقًا لـ input_schema؛ وتُرفض الحقول الإضافية مثل tool_id وquote_id وmax_cost_usd. تسري عروض الأسعار لمدة 300 ثانية وترتبط بالمفتاح نفسه والإصدار الدقيق والمدخلات المطبّعة وإعدادات التسعير/المصدر. تعيد tool_id/version/maximum_usd ولا ترسل إلى الجهة المنبعية.

المصادقة والصلاحيات

استخدم مفتاح GloopAPI الحالي. تعتمد النماذج والإمكانات والصلاحيات المتاحة على دليله ووثائق نقطة النهاية.

Authorization: Bearer $GLOOP_API_KEY

آليات المصادقة: BearerAuth

الطلب

معاملات المسار

  • idstringمطلوب

    معرّف أداة في الدليل أو معرّف تشغيل الأداة الأصلي، بحسب كائن العملية الحالية.

جسم الطلب · application/json

النوع
object
الحقول المطلوبة
versioninput
خصائص إضافية
false

جسم الطلب مطلوب

  • versionstringمطلوب

    إصدار عقد أداة غير فارغ ومطلوب. استخدم الإصدار الدقيق من التفاصيل؛ ولا يُستخدم الإصدار الحالي افتراضيًا.

    الحد الأدنى للطول
    1
    النمط
    ".*\\S.*"
  • inputunknownمطلوب

    يجب أن يجتاز input_schema لهذا الإصدار من الأداة. يُقبل JSON المعياري فقط؛ وتُحظر الحقول الإضافية مثل route_id الخاص بالمسؤول.

الاستجابات والأخطاء

HTTP 200

تم الحصول على عرض سعر الأداة بنجاح

application/json

النوع
object
الحقول المطلوبة
quote_idmaximum_usdprice_versionexpires_atcomponentstool_idversion
  • quote_idstringمطلوب

    المعرّف العام لعرض السعر؛ يجب أن يستوفي ارتباط السعر والطلب عند الإنشاء.

  • maximum_usdstringمطلوب

    الحد الأقصى للحجز بالدولار الأمريكي لهذه المدخلات المطبّعة.

  • price_versionintegerمطلوب

    مراجعة سعر البيع.

  • expires_atintegerمطلوب

    انتهاء بثواني Unix؛ عرض الأداة صالح 300 ثانية وفق expires_at الفعلي.

  • componentsunknownمطلوب

    قيمة JSON يحددها مخطط الأداة المختارة أو البروتوكول؛ لا تفترض حقولًا ثابتة.

  • tool_idstringمطلوب

    معرّف الأداة المرتبط بعرض السعر هذا.

  • versionstringمطلوب

    إصدار عقد الأداة الدقيق المرتبط بعرض السعر هذا.

HTTP 400

حقول الطلب أو معاملاته غير صالحة.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 401

Key مفقود أو غير صالح أو منتهي أو ملغى.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 403

صلاحيات IP أو الحساب أو النموذج أو الأداة غير كافية.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 404

الكائن/الإمكانية غير متاحين، أو مفتاح الميزة معطّل.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 409

تعارض في منع التكرار/عرض السعر، أو كائن غير جاهز، أو ما يزال مشارًا إليه.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 429

حد معدل الطلبات/قائمة الانتظار.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 500

فشل داخلي في المصادقة أو تخزين البيانات.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 503

الخدمة أو التسعير أو التخزين غير متاح.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)