تم استخدام باخرة لبرمجة تطبيقات الدفع للوكلاء

تتيح واجهة برمجة تطبيقات الدفع للوكلاء لوكيل ذكاء اصطناعي إدارة وشراء رصيد واجهة برمجة التطبيقات تلقائيًا نيابةً عن المستخدم. وهذا يُمكّن من سير العمل دون تدخل بشري، حيث يستطيع الوكيل التحقق من رصيده المتبقي، ومراجعة حدود الإنفاق، وإعادة شحن الرصيد عبر طريقة الدفع المحفوظة للمستخدم على Stripe، كل ذلك دون تدخل بشري.

جميع نقاط النهاية الثلاث مستضافة على payments.builtwith.com وقم بالمصادقة باستخدام مفتاح واجهة برمجة التطبيقات (API) الخاص بك من BuiltWith.

مرر مفتاح واجهة برمجة تطبيقات الوكيل باستخدام إحدى الطريقتين أدناه. يُعطى مُعامل الاستعلام KEY الأولوية في حال توفير كليهما.

Authorization: Bearer 00000000-0000-0000-0000-000000000000

?KEY=00000000-0000-0000-0000-000000000000

الطلبات التي تحتوي على مفتاح مفقود أو غير صالح أو معطل تُرجع رمز HTTP 401. الحسابات التي تم تعليق فوترتها تُرجع رمز HTTP 403.

Reference https://api.builtwith.com/llms.txt and
https://raw.githubusercontent.com/builtwith/builtwith-ai-sdk/refs/heads/main/README.md
Add BuiltWith Agent Payment API support to my app. Check the current API credit balance,
and if below 1000 credits, purchase 2000 more using the Agent Payment API.
If mppx aliases have been manually enabled for this workflow, use
https://api.builtwith.com/mppx/openapi.json and the Agent Payment API routes
https://api.builtwith.com/mppx/api-discovery,
https://api.builtwith.com/mppx/api-configuration, and
https://api.builtwith.com/mppx/api-purchase.

بعد التفع��ل اليدوي، يمكن للوكلاء استخدام أسماء مستعارة لنطاقات واجهة برمجة التطبيقات المتوافقة مع mppx لواجهة برمجة تطبيقات دفع الوكلاء الحالية. تستخدم هذه المسارات نفس مصادقة مفتاح واجهة برمجة التطبيقات BuiltWith، وطريقة دفع Stripe المحفوظة، وحدود الإنفاق على فوترة واجهة برمجة تطبيقات الوكلاء الموضحة أدناه.

GET https://api.builtwith.com/mppx/openapi.json

GET https://api.builtwith.com/mppx/api-discovery

GET https://api.builtwith.com/mppx/api-configuration

POST https://api.builtwith.com/mppx/api-purchase

{ "credits": 2000 }

أرسل مفتاح واجهة برمجة تطبيقات الوكيل كعنوان Authorization: Bearer أو كمعامل استعلام KEY، تمامًا كما هو الحال مع نقاط نهاية واجهة برمجة تطبيقات دفع الوكيل على payments.builtwith.com.

يُعيد رصيد الائتمان الحالي للحساب عبر واجهة برمجة التطبيقات (API).

GET https://payments.builtwith.com/v1/billing/api-discovery?KEY=00000000-0000-0000-0000-000000000000

{
  "credits_total": 10000,
  "credits_used": 1234,
  "credits_available": 8766
}

يعرض هذا النظام حدود الإنفاق المحددة مسبقًا ومقدار الإنفاق الشهري المُستخدَم منها. ينبغي على الموظف التحقق من ذلك قبل محاولة الشراء لتجنب رفض الطلبات.

GET https://payments.builtwith.com/v1/billing/api-configuration?KEY=00000000-0000-0000-0000-000000000000

{
  "max_per_purchase": 5000,
  "max_monthly": 20000,
  "monthly_purchased": 5000,
  "monthly_remaining": 15000,
  "cost_per_2000_credits_usd": 99.00
}

يتم خصم المبلغ من طريقة الدفع المحفوظة لدى المستخدم على منصة Stripe، ويتم إضافة الرصيد إلى الحساب فورًا. تخضع عملية الشراء للحدود المحددة لكل عملية شراء والحدود الشهرية المحددة في إعدادات فوترة واجهة برمجة تطبيقات الوكيل.

POST https://payments.builtwith.com/v1/billing/api-purchase

أرسل مفتاح واجهة برمجة تطبيقات الوكيل كـ Authorization: Bearer أو كـ ?KEY= مُعامل الاستعلام. يجب أن يكون نص الطلب بصيغة JSON.

{ "credits": 2000 }

{
  "success": true,
  "credits_purchased": 2000,
  "cost_usd": 99.00,
  "payment_id": "pi_3abc123xyz",
  "credits_available": 10766
}

لاحظ أن رسائل الخطأ بهذا التنسيق لا يمكن ضمانها، ويجب على تطبيقك أيضًا أن يأخذ في الاعتبار أكواد الاستجابة غير 200 كأخطاء. ستكون خاصية البحث فارغة (json) أو غير متوفرة (xml) إذا كان الخطأ متعلقًا بالخادم. عرض جميع رموز الأخطاء المحتملة ذات التكوين الجيد.

ملكنا الشروط القياسية تغطية استخدام كافة واجهات برمجة التطبيقات لدينا.

بشكل عام، يمكنك استخدام واجهة برمجة التطبيقات (API) لتحسين منتجك بطرق عديدة. القيد الوحيد هو عدم إمكانية إعادة بيع البيانات كما هي أو توفير وظائف مكررة لـbuiltwith.com والخدمات المرتبطة بها.