Api Open Platform V1

Open Platform API v1

/api/v1 是 StackPanel 的版本化开放平台。它不是第二套业务实现：内核和插件能力均转发到同一业务 handler，并通过同一套认证、权限、配额、幂等和审计路径执行。

认证与授权

使用会话 Cookie 或平台 API Token：

Authorization: Bearer sp_...

Token 的有效权限是 token scopes 与持有者当前权限的交集。需要写入时，发送唯一的 Idempotency-Key；详见幂等。

curl https://panel.example.com/api/v1/capabilities \
  -H 'Authorization: Bearer sp_...'

根据返回的能力清单决定可调用操作。不要硬编码“管理员 token 必然能调用全部接口”的假设。

契约来源

路径、方法、scope 和 OpenAPI operation 来自 capability registry。运行中的 /docs 和 apps/api/contracts/openapi-v1.snapshot.json 是可验证投影；接口表格只是导航。