CrashSight OpenAPI 双模调用参考
| 脚本方式 | SDK 方式 | |
|---|---|---|
| 鉴权 | 手动生成签名拼 URL | 自动处理 |
| 参数 | 原始 camelCase JSON body | Python snake_case 关键字参数 |
| 响应 | 原始 {ret: {data: ...}} | 已解包，直接返回 data 内容 |
| 错误 | 需自行判断 code != 200 | 自动抛出 CrashSightAPIError |
| 适用场景 | 非 Python 环境、调试、直接对接 HTTP | Python 项目主力调用方式 |
公共设置
脚本方式（通用）
SDK 方式（初始化一次全局复用）
调用示例（以三个典型接口展示规律）
示例 1 — POST 接口，返回列表
getTrendEx / get_trend示例 2 — 需要 issue_id 的级联查询
issueInfo + lastCrashInfo + crashDoc示例 3 — GET 旧式接口（路径参数）
noteList（GET），签名追在 ? 参数后面用 &错误处理（SDK）
注意事项
| 接口 / 场景 | 说明 |
|---|---|
| 频率限制 | 同一用户所有接口合计 25 次/分钟 |
platformId 类型 | issueInfo、lastCrashInfo、crashDoc、appDetailCrash 的 platformId 传字符串；SDK 已自动处理 |
getMinuteCrashData | 响应慢（>30s），建议 CrashSightClient(timeout=120) |
getNetworkDevices | 偶发响应慢，建议 timeout=60 |
| 移动端专用 | getNetworkDevices、getCrashDeviceInfo、getDeviceUserInfo 等仅支持 platformId=1/2 |
| App 级鉴权 | getStackCrashStat、getCrashDeviceStat、getStackDeviceInfo、getCrashDeviceInfoByExpUid 需 appSecret/X-token，HMAC 用户鉴权不适用 |
修改于 2026-04-01 07:01:26