密钥权限范围
项目限制
项目 (Project) 字段把 API 密钥限定到特定项目：
- 任意 (Any)——密钥可访问账户中的所有项目
- 特定项目——密钥只处理所选项目的数据
限制的表现因方法而异。在列表方法中它是过滤器：响应成功，但只包含该项目的数据。在针对具体收款单或钱包的方法中，请求其他项目的对象会被拒绝并返回 Restricted project。
| 方法 | 密钥限定到项目时 |
|---|---|
billing/balances | 账户级数据，限制不适用 |
billing/history | 该项目的操作，加上账户级操作——充值和赠金 |
billing/tariffs | 只有密钥所属项目的费率和流水 |
invoices/list | 结果只含密钥所属项目 |
payments/list | 结果只含密钥所属项目 |
statistics/invoices | 只按密钥所属项目计算 |
statistics/payments | 只按密钥所属项目的收款单计算 |
invoices/create | 请求中的 projectId 必须与密钥所属项目一致 |
invoices/cancel | 无法访问其他项目的收款单 |
invoices/bindPayment | 无法访问其他项目的收款单 |
权限范围限制
权限范围定义密钥可以使用哪些 API 方法。这是必填的多选字段。
调用密钥权限范围之外的方法会被拒绝并返回 Restricted scope。
限制的组合
项目限制和权限范围限制同时生效。例如，密钥限定为收款单方法并绑定到特定项目时：
- 只有收款单方法可用
- 数据只过滤出指定项目的
- 请求付款或统计会被拒绝
- 请求其他项目的数据会被拒绝