エージェント決済APIを搭載

エージェント決済APIを使用すると、AIエージェントがユーザーに代わってAPIクレジットを自律的に管理および購入できます。これにより、エージェントが残りのクレジット残高を確認したり、支出限度額を確認したり、ユーザーが保存したStripe決済方法を使用してクレジットを補充したりといった作業を、人間の介入なしに自動で行うことができます。

3つのエンドポイントはすべて、 payments.builtwith.com BuiltWith APIキーを使用して認証してください。

以下のいずれかの方法でエージェントAPIキーを渡してください。両方が指定されている場合は、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.

手動で有効化した後、エージェントは既存のエージェント支払いAPIに対してmppx互換のAPIドメインエイリアスを使用できます。これらのルートは、後述するBuiltWith APIキー認証、保存済みのStripe支払い方法、およびエージェントAPI請求の支出制限をそのまま使用します。

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 }

エージェントAPIキーは、authorization: Bearerヘッダーとして、またはKEYクエリパラメータとして送信してください。これは、payments.builtwith.comのエージェント支払いAPIエンドポイントの場合とまったく同じです。

アカウントの現在の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決済方法に請求を行い、アカウントに即座にクレジットを付与します。購入は、エージェントAPIの請求設定で設定された購入ごとの上限および月間上限の対象となります。

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

エージェントAPIキーを送信します Authorization: Bearer ヘッダーとして、または ?KEY= クエリパラメータ。リクエストボディはJSON形式である必要があります。

{ "credits": 2000 }

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

注意: この形式のエラー メッセージは保証されません。実装では、200 以外の応答コードもエラーとして扱う必要があります。 エラーがサーバー関連の場合、Lookup プロパティは null (json) または提供されません (xml)。 すべての潜在的なエラーコードを表示する.

私たちの 標準用語 当社のすべての API の使用をカバーします。

一般的に、API は様々な方法で製品を拡張するために使用できます。唯一の制限は、データをそのまま再販したり、builtwith.com および関連サービスに重複した機能を提供したりできないことです。