SDK
SDK 更新日志
翠鸟 SDK 各版本的功能更新、问题修复与破坏性变更记录
版本历史
翠鸟 SDK 遵循语义化版本规范（SemVer）。主版本号变更表示有破坏性改动，次版本号表示新功能，修订号表示 Bug 修复。
v3.2.0
MINOR
2024-03-10
新增功能
- 新增
CuiniaoClient.leads().batchCreate()方法，支持批量导入线索（最多100条/次） - 追踪模块新增
onLeadCreated回调钩子，可在线索创建时执行自定义逻辑 - 数据分析 API 新增漏斗分析端点封装
analytics().getFunnel() - 支持通过
CuiniaoConfig.setProxy()配置 HTTP 代理
问题修复
- 修复在 JDK 17 以上版本中使用反射 API 导致的模块访问异常
- 修复
ResourceClient.list()分页参数cursor为空时抛出 NPE 的问题
v3.1.2
PATCH
2024-02-22
问题修复
- 修复在网络超时后连接未正确释放回连接池的内存泄漏问题
- 修复 Webhook 签名验证在含特殊字符的 payload 上失败的 bug
- 修复
LeadStatus.fromString()对未知状态值抛出未检查异常的问题，现在返回UNKNOWN
依赖更新
- 升级 OkHttp 从 4.11.0 至 4.12.0，修复若干安全漏洞
- 升级 Jackson 从 2.15.2 至 2.16.1
v3.1.0
MINOR
2024-01-18
新增功能
- 新增异步 API 支持：所有方法新增
Async变体，返回CompletableFuture - 新增
CuiniaoClient.webhooks()模块，支持 Webhook 端点的 CRUD 管理 - 新增本地 Webhook 签名验证工具类
WebhookVerifier
优化改进
- HTTP 连接池默认并发连接数从 5 提升至 20
- 日志输出优化，新增结构化日志支持（SLF4J）
v3.0.0
MAJOR
2023-11-05
破坏性变更
- 包名变更：
com.cuiniao.sdk.*替代原有的com.kingfisher.api.* - 初始化方式变更：使用 Builder 模式，
new CuiniaoClient.Builder().apiKey(...).build() - 移除废弃方法：v2.x 中标注为
@Deprecated的所有方法已删除
新增功能
- 全新重写的 HTTP 客户端，基于 OkHttp 4.x，支持 HTTP/2
- 新增自动重试机制，默认对 5xx 错误重试3次（指数退避）