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

تسجيل الدخول اشتراك
مقدمة

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

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

قبل أن يتمكن الوكيل من استخدام نقاط النهاية هذه، يجب على المستخدم تمكين فوترة واجهة برمجة تطبيقات الوكيل وتكوين حدود الإنفاق في https://payments.builtwith.com/agent-payment-api-config.
المصادقة

مرر مفتاح واجهة برمجة تطبيقات الوكيل باستخدام إحدى الطريقتين أدناه. يُعطى مُعامل الاستعلام 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.
GET /v1/billing/api-discovery — رصيد دائن

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

طلب

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

حقول الاستجابة
مجاليكتبوصف
credits_totalnumberإجمالي الرصيد المخصص للحساب على الإطلاق.
credits_usednumberالرصيد المستهلك من خلال استدعاءات واجهة برمجة التطبيقات حتى الآن.
credits_availablenumberالرصيد المتبقي القابل للاستخدام (الإجمالي مطروحًا منه الرصيد المستخدم). هذا ما يجب على الوكيل التحقق منه قبل إجراء استدعاءات واجهة برمجة التطبيقات (API).
مثال على الاستجابة
{
  "credits_total": 10000,
  "credits_used": 1234,
  "credits_available": 8766
}
GET /v1/billing/api-configuration — حدود الإنفاق

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

طلب

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

حقول الاستجابة
مجاليكتبوصف
max_per_purchasenumberالحد الأقصى للائتمانات التي يمكن للوكيل شراؤها في معاملة واحدة.
max_monthlynumberالحد الأقصى للائتمانات التي يمكن للوكيل شراؤها خلال الشهر التقويمي الحالي.
monthly_purchasednumber الرصيد الذي اشتراه الوكيل بالفعل خلال هذا الشهر.
monthly_remainingnumberكم عدد الرصيد الإضافي الذي يمكن شراؤه هذا الشهر قبل الوصول إلى الحد الشهري؟
cost_per_2000_credits_usdnumberتكلفة الدولار الأمريكي لعملية شراء بحد أدنى 2000 رصيد. استخدم هذه القيمة لتقدير تكلفة عملية شراء مُخطط لها.
مثال على الاستجابة
{
  "max_per_purchase": 5000,
  "max_monthly": 20000,
  "monthly_purchased": 5000,
  "monthly_remaining": 15000,
  "cost_per_2000_credits_usd": 99.00
}
POST /v1/billing/api-purchase — شراء الاعتمادات

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

طلب

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

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

نص الطلب
مجاليكتبمطلوبوصف
creditsnumberنعمعدد النقاط المطلوبة للشراء. الحد الأدنى 2000 نقطة. يجب ألا يتجاوز max_per_purchase أو البدل الشهري المتبقي.
استجابة النجاح (HTTP 200)
مجاليكتبوصف
successbooleantrue
credits_purchasednumberتمت إضافة رصيد إلى الحساب.
cost_usdnumberالمبلغ المدفوع بالدولار الأمريكي.
payment_idstringمعرّف Stripe PaymentIntent للمطابقة.
credits_availablenumberتم تحديث رصيد الائتمان المتاح بعد الشراء.
نص الطلب النموذجي
{ "credits": 2000 }
مثال على استجابة النجاح
{
  "success": true,
  "credits_purchased": 2000,
  "cost_usd": 99.00,
  "payment_id": "pi_3abc123xyz",
  "credits_available": 10766
}
ردود الأخطاء
HTTPمعنى
400فشل التحقق - الرصيد أقل من 2000، أو يتجاوز الحد الأقصى لكل عملية شراء، أو سيتم تجاوز الحد الشهري.
401مفتاح واجهة برمجة تطبيقات الوكيل مفقود أو غير صالح.
402فشلت عملية الدفع عبر Stripe أو لا توجد طريقة دفع قابلة للدفع مسجلة.
403تم تعليق عملية فوترة الحساب.
405الطريقة غير مسموحة - نقطة النهاية تتطلب POST.
المجالات الخاصة

نحتفظ بقائمتين لاستخدامك عند البحث عن النطاقات: قوائم التجاهل وقوائم اللاحقات المبنية.

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

BuiltWith قائمة اللواحق
وهذا يعتمد على قائمة اللواحق العامة لكنها تتضمن العديد من الإدخالات الإضافية للشركات التي لديها نطاقات فرعية يجب اعتبارها نطاقات المستوى الأعلى. توفر لنا هذه القائمة رؤية أفضل لمواقع الويب الداخلية، على سبيل المثال، فهي ترفع موقع northernbeaches.nsw.gov.au إلى المستوى الأعلى مقارنة بـ nsw.gov.au.

تجاهل المجالات (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
نطاقات اللواحق (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
رموز الخطأ

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

شروط الاستخدام

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

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