برمجة تطبيقات تعبئة رصيد الشريط من الوكيل

تتيح واجهة برمجة تطبيقات Agent Stripe Credit Top-Up لوكيل الذكاء الاصطناعي التحقق من رصيد API الخاص بالحساب، وضمن حدود يحددها المستخدم، تحصيل رسوم من طريقة الدفع Stripe المحفوظة في الحساب لإضافة المزيد من أرصدة الحساب.

جميع نقاط النهاية الرئيسية الثلاث مستضافة على payments.builtwith.com.

انسخ مفتاح فوترة الوكيل ذي النطاق المنفصل من صفحة إعدادات الفوترة وأرسله في ترويسة التفويض. لا يمكن لمفاتيح واجهة برمجة تطبيقات BuiltWith العامة ورموز bw-device المؤقتة شراء أرصدة.

Authorization: Bearer YOUR_AGENT_BILLING_KEY

تم إيقاف استخدام معلمة الاستعلام KEY القديمة لأن بيانات الاعتماد في عناوين URL يمكن الاحتفاظ بها في السجلات وسجل المتصفح.

الطلبات التي تحتوي على مفتاح مفقود أو غير صالح أو معطل تُرجع رمز 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 Stripe Credit Top-Up API support to my app. This is saved-card
account billing, not x402. Check the account API-credit balance and, if below 1000,
purchase 2000 more using a unique Idempotency-Key and the scoped Agent Billing Key.
If the legacy mppx path aliases are desired, 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 القديمة هذه واجهة برمجة تطبيقات تعبئة الرصيد باستخدام طريقة الشريط المحفوظة. وهي ليست x402 ولا تُعيد أو تقبل رؤوس تحدي الدفع.

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 وقم بتضمين مفتاح Idempotency-Key فريد في عمليات الشراء.

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

GET https://payments.builtwith.com/v1/billing/api-discovery
Authorization: Bearer YOUR_AGENT_BILLING_KEY

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

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

GET https://payments.builtwith.com/v1/billing/api-configuration
Authorization: Bearer YOUR_AGENT_BILLING_KEY

{
  "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 YOUR_AGENT_BILLING_KEY, وأرسل رمزًا فريدًا Idempotency-Key. أعد استخدام هذا المفتاح فقط عند إعادة محاولة عملية الشراء نفسها.

Authorization: Bearer YOUR_AGENT_BILLING_KEY
Idempotency-Key: 72b7b97c-3b6d-4c64-9bbf-20fd2a931514
Content-Type: application/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 والخدمات المرتبطة بها.