Machine Payments Protocol (MPP)

HTTP 402、Tempo USDC、支払いレシートで TwexAPI リクエストを従量課金する。

Machine Payments Protocol (MPP)

TwexAPI は選択された従量課金リクエスト向けに Machine Payments Protocol (MPP) をサポートしています。MPP クライアントは TwexAPI API キーを送らず、Tempo USDC で対象リクエストの支払いができます。

MPP は、行ったリクエスト分だけ支払いたいエージェント、スクリプト、サービスに有用です。以下にないエンドポイントの API キー認証は置き換えません。

サポート操作

Operation	What it does	Payment method	Price
`POST /twitter/advanced_search/page`	高度 Twitter 検索結果のカーソルベース 1 ページを返す。	Tempo USDC	ページあたり USD 0.0001

現在の支払いオファーの権威はサーバーです。金額、受取人、支払い認証形式をハードコードせず、リクエストに返る WWW-Authenticate: Payment チャレンジを読んでください。

支払いの流れ

API キーなしで MPP 対応エンドポイントへ通常リクエスト。
サーバーは 402 Payment Required と WWW-Authenticate: Payment チャレンジを返す。
MPP クライアントはチャレンジ記述の Tempo USDC リクエストを支払い、Authorization: Payment 認証情報でリトライ。
決済済みレスポンスには Payment-Receipt ヘッダー。HTTP ステータスとレスポンスボディの両方を確認 — レシートは支払い決済のみを証明。

Payment challenge

HTTP/2 402 Payment Required
WWW-Authenticate: Payment id="abc...", realm="api.twexapi.io", method="tempo", intent="charge", request="eyJhbW91bnQiOi..."

チャレンジの request 値に現在の支払い指示が含まれます。MPP クライアント向け不透明データとして扱い、キャッシュ例から支払いを組み立てないでください。

Paid retry and receipt

POST /twitter/advanced_search/page HTTP/2
Host: api.twexapi.io
Authorization: Payment eyJjaGFsbGVuZ2UiOnsi...
Content-Type: application/json

{"searchTerms":["openai"],"sortBy":"Latest"}

HTTP/2 200 OK
Payment-Receipt: eyJzdGF0dXMiOiJzdWNjZXNzIiwi...
Content-Type: application/json

MPP と API キー

Choose	When it fits
MPP	サポート操作への匿名・従量課金リクエストが必要。
API key	TwexAPI 全表面、アカウントクレジット、MPP オファー未公開エンドポイントが必要。

MPP 支払いは USDC 入金済み Tempo ウォレットを使用。秘密鍵は環境変数に置き、ソース管理、ログ、チャットにコミットしないでください。

次のステップ

MPP quickstart — クライアントインストール、Tempo ウォレット設定、有料検索リクエスト。
API overview — API キー認証と TwexAPI エンドポイントカタログ全体。