错误码错误码
一、错误码规则
Section titled “一、错误码规则”采用 4 位数字编码，规则如下：
- 1 开头（1xxx）：SDK 基础与配置错误（客户端自身问题）。
- 3 开头（3xxx）：服务端业务错误（AppKey、广告位 ID、签名校验失败）。
- 5 开头（5xxx）：服务器内部错误（SSP 报 500）。
| 错误码 | 常量 | 说明 |
|---|---|---|
| 1000 | SDK_ERROR | SDK 端通用错误 |
| 1001 | APP_KEY_EMPTY | AppKey 为空 |
| 1002 | INVALID_PARAMS | 无效的 AdConfig 参数 |
| 1003 | ALREADY_INITIALIZED | 重复初始化 |
| 1010 | NETWORK_UNAVAILABLE | 无网络 / 主机不可达 |
| 1011 | NETWORK_TIMEOUT | 网络超时 |
| 1012 | NETWORK_ERROR | 网络错误 |
| 1020 | RESPONSE_PARSE_ERROR | SSP 响应解析错误 |
| 1100 | SDK_NOT_INITIALIZED | SDK 尚未初始化 |
| 1101 | SDK_DISABLED | SDK 已关闭 |
| 1102 | PLACEMENT_ID_EMPTY | 广告位 ID 为空 |
| 1103 | API_CLIENT_UNAVAILABLE | ApiClient 不可用 |
| 1110 | MATERIAL_TIMEOUT | 素材预取超时 |
| 1111 | MATERIAL_DOWNLOAD_FAIL | 素材预取下载失败 |
| 1112 | MATERIAL_EXTRACT_FAIL | 试玩广告解压失败 |
| 1200 | AD_EXPIRED | 广告已过期 |
| 1201 | AD_DESTROYED | 广告实例已 destroy |
| 1202 | AD_NOT_READY | 广告尚未 Ready |
| 1203 | HOST_ACTIVITY_DESTROYED | 宿主 Activity 已销毁或 finishing |
| 1210 | RENDER_FAIL | 展示渲染失败 |
| 3000 | SSP_ERROR | 服务端通用错误 |
| 3001 | NO_AD_FILL | 无广告填充 |
| 3002 | INVALID_REQUEST | 请求体解析错误 |
| 3003 | INVALID_APP_KEY | App 下架或不存在 |
| 3004 | INVALID_PLACEMENT | 广告位关闭或不存在 |
| 3005 | INVALID_SIGNATURE | 签名失败 |
| 3006 | FREQUENCY_LIMITED | 频次限制，该设备/用户触发了该广告位设定的频次控制 |
| 3007 | REQUEST_EXPIRED | X-Timestamp 与服务器时间相差过大 |
| 3008 | REPLAY_ATTACK_DETECTED | 服务端检测到重复的 X-Nonce，判定为重放攻击 |
| 3009 | RATE_LIMIT_EXCEEDED | 服务器限流（Rate Limit）触发，拒绝高频的非法刷量请求 |
| 3010 | INVALID_PLACEMENT_TYPE | 广告位类型本版本不支持 |
| 5000 | SERVER_INTERNAL_ERROR | SSP 广告服务器内部未知异常 |