Proxy-seller

承認

Updated:

x402 APIには、アカウント、パスワード、APIキーは存在しません。その代わりに、支払い署名、注文のアクセストークン、ウォレット署名の3種類の認証情報が使用されます。

アクセストークンを第三者に提供しないでください。また、ウォレットの秘密鍵は、当社を含め、いかなる第三者にも絶対に送信しないでください。

主な特徴

支払いの署名

支払いに署名するウォレットが購入者となります。最初の支払いが成功すると、自動的にウォレットアカウントが作成されるため、登録手続きは一切必要ありません。注文の更新および居住地トラフィックは、その注文の支払いに使用されたウォレットからのみ支払うことができます。

アクセストークン

有料のご注文にはすべて、access_token かつて、ある時、202 回答。以下に送信してください。Authorization この注文に関するすべてのリクエスト(ステータスや認証情報、更新、トラフィック、設定、IPの変更、イベントなど)には、ヘッダーを添付してください。

ウォレットの署名

注文用の新しいトークンを取得したり、残高を引き出したりするには、同じウォレットでワンタイムSMS(EIP-4361)に署名してください。署名を行っても資金は移動しません。

アクセストークン

Authorization: Bearer x402_q8Zt3Lw0mN6pR2vY9cK4hJ7sD1fG5bX8aE3uW0iO2nT

プロパティ

価値

書式

x402_ その後に43文字が続きます。単語Bearer 大文字小文字は区別されません

場所

以下の場合に限り、Authorization ヘッダー。クエリ文字列内のトークンは受け付けられません

範囲

1件のご依頼:/orders/{id} およびそのサブリソース(この注文の更新やトラフィックを含む)。チャージトークンは、以下の場合にのみ有効になりますGET /topup/{id}

発行済み

各操作につき1回、202 応答。24時間以内に同じ署名付きリクエストを繰り返すと、同じトークンが返されます。その後、新しいトークンは以下の場合のみ発行されます。アクセス権の回復

有効期間

注文の有効期限からさらに90日間。更新により期間が延長されます。有効期限のない操作については、最終ステータスから90日間。

取り消し

ウォレットのブロック、revoke_existing inアクセス権の回復、またはご要望に応じてサポートいたします

新しいトークンが古いトークンを無効にすることはありません。注文の有効なトークンはすべて引き続き機能します。

誤り

回答

いつ

401 unauthorized

TheAuthorization ヘッダーが欠落しているか、またはBearer x402_…

404 order_not_found

その他の問題:オーダーが存在しない、トークンが別のオーダーに属している、トークンが失効または期限切れになっている。APIではこれらのケースを区別しない

例

401: アクセス拒否

{
    "error": "unauthorized",
    "message": "Authorization is required",
    "retryable": false,
    "retry_action": "abandon",
    "detail": "Authorization: Bearer <access_token> from the order response is required"
}

失われたトークン

トークンを紛失した場合は、ウォレットを使用してアクセス権を回復してください:アクセス権の回復。この応答には、新しいトークンを含むウォレットのすべての注文が一覧表示されています。

On this page