账户结构
所有 API 凭证和 Webhook 设置均在主账户层统一配置,并对全部子账户生效。创建子账户的方法参见账户入驻。
列出关联账户
调用 List Connected Accounts 接口获取主账户下所有关联的子账户。account_id 字段 — 在代表特定子账户发起请求时需要使用此值。
代表子账户操作
要把一次 API 请求限定在某个子账户的范围内,请在请求中加入x-on-behalf-of header,并将其值设为该子账户的 account_id。
如果省略
x-on-behalf-of,该请求默认视为由主账户发起。x-on-behalf-of header 用于确保操作被限定在正确的账户范围内。
何时不要传 x-on-behalf-of
该 header 仅用于操作子账户范围内资源的接口。不要在主账户层级的操作上加这个 header —— 例如列出关联账户、签发 Access Token 等。如果一个请求并不针对子账户范围内的资源,请直接省略 x-on-behalf-of。
错误处理
当x-on-behalf-of 值无效,或目标子账户处于停用状态时,API 返回:
account_id 是否正确,并确认目标子账户处于激活状态。

