跳到主要内容
盘盘枢

权限模型

权限说明

看懂从套餐、子 key 到接口请求的授权链路。PanShu 面向数据接入，不提供投资建议；所有权限说明只服务于数据接口使用和运维排障。

查看接口目录对比套餐

套餐

权限基线

套餐写入积分门槛、分钟频控和日配额，是子 key 的默认授权来源。

子 key

调用凭证

子 key 只在签发时展示完整明文；后续列表只展示前缀、状态、套餐和有效期。

接口目录

逐项判定

每个 API 都带有接口模式、最低积分要求、参数和字段说明，调用前可先在目录确认。

频控配额

请求边界

分钟频控和日配额在 Serving Plane 本地判定，超限会快速拒绝并给出重试语义。

一次请求如何被判定

Serving Plane 先做本地授权和配额判定，再决定是否进入数据读取路径。

  1. 1

    校验子 key 是否存在、启用且未过期。

  2. 2

    读取子 key 绑定套餐，确认套餐仍处于可用状态。

  3. 3

    按套餐积分或 allowlist 校验目标接口权限。

  4. 4

    同时检查全局分钟频控、单接口频控和日配额。

  5. 5

    通过鉴权后再进入本地快照或回源路径；Serving Plane 不持有 Tushare token。

接口模式

目录中的 mode 决定数据读取路径和授权解释方式。

本地加速

本地加速接口

优先从 PanShu 本地快照返回，适合高频读取、回测和常用查询。

实时透传

实时透传接口

覆盖不到的数据由 Serving 调 Origin 回源，仍沿用 Tushare wire 返回语义。

独立权限

独立权限接口

需要单独授权或更高门槛，未授权时会在本地快速拒绝，不撞上游。

常见拒绝与处理

先判断是 Portal 登录问题，还是 wire 子 key 的接口权限、频控或配额问题。

状态场景处理方式
401Portal 登录态失效重新登录后再进入控制台。Portal JWT 不等同于 wire 子 key。
40203套餐积分不足或接口未授权查看接口目录的最低积分要求，或切换到更高套餐/独立授权 key。
40203分钟频控或日配额耗尽按 Retry-After 退避重试；批量任务应做排队和限速。
not found接口名或 key 前缀不存在确认 api_name 拼写、key 状态和是否使用了完整 wire 子 key。