授权 | Proxy-seller

x402 API 不使用账户、密码或 API 密钥。取而代之的是三种验证方式：支付签名、订单的访问令牌以及钱包签名。

请勿将访问令牌提供给第三方，也绝不要将钱包的私钥发送给任何人，包括我们。

主要特点

付款签名

进行支付签名的钱包即为买家。首次成功支付后会自动创建钱包账户，无需注册。订单的续费及住宅流量费用只能通过支付该订单的钱包进行支付。

访问令牌

每笔付费订单将返回一个access_token 有一次，在202 回复。请将其发送至Authorization 针对该订单的每项请求均需包含标题：状态与凭证、续订、流量、设置、IP 替换及事件。

钱包签名

若要为订单获取新代币或提取余额，请使用同一钱包签署一条一次性短信（EIP-4361）。签署操作不会转移资金。

访问令牌

Authorization: Bearer x402_q8Zt3Lw0mN6pR2vY9cK4hJ7sD1fG5bX8aE3uW0iO2nT

属性	价值
格式	`x402_` 后跟43个字符。该词`Bearer` 不区分大小写
在哪里	仅在`Authorization` 标题。不接受查询字符串中的令牌
范围	一项任务：`/orders/{id}` 及其子资源，包括此类订单的续订和流量。充值代币仅可`GET /topup/{id}`
已发布	每项操作仅需在`202` 响应。在 24 小时内重复发送相同的签名请求将返回相同的令牌。此后，新令牌仅由恢复访问权限
Lifetime	截至订单到期日加90天；续订将延长该期限。对于无到期日的操作，则自其最终状态确定之日起90天后。
撤销	钱包被封，`revoke_existing` in恢复访问权限，或根据要求提供支持

新代币不会撤销旧代币：同一订单中的每个有效代币均保持有效。

错误

回复	当
`401 unauthorized`	该`Authorization` 标题缺失或不`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