API 参考

SOVR SDK 提供 Python 和 Node.js 两种语言的客户端库。

SDK 版本

语言	包名	最新版本	状态
Python	sovr-sdk	0.1.0	Beta
Node.js	@sovr/sdk	0.1.0	Beta

核心类

SOVRClient

主客户端类，提供所有 API 操作的入口。

• Python SOVRClient
• Node.js SOVRClient

TrustBundle

信任包管理相关的 API。

• Python TrustBundle
• Node.js TrustBundle

Decision

决策管理相关的 API。

• Python Decision
• Node.js Decision

通用参数

分页参数

所有列表 API 都支持分页：

参数	类型	默认值	说明
limit	int	20	每页数量，最大 100
offset	int	0	偏移量

时间范围参数

支持时间范围过滤的 API：

参数	类型	说明
start_time	datetime	开始时间
end_time	datetime	结束时间

错误处理

错误码

错误码	说明
400	请求参数错误
401	认证失败
403	权限不足
404	资源不存在
429	请求过于频繁
500	服务器内部错误

异常类

• Python 异常处理
• Node.js 错误处理

速率限制

环境	限制
生产环境	1000 请求/分钟
沙盒环境	100 请求/分钟

超出限制时会返回 429 错误，响应头包含：

• X-RateLimit-Limit: 限制数量
• X-RateLimit-Remaining: 剩余数量
• X-RateLimit-Reset: 重置时间