X-API-Version 响应头
所有 v1 响应现在都包含 X-API-Version: 1.0.0 响应头。客户端可使用此响应头验证是哪个 API 版本提供了响应,并在集成中实现版本感知逻辑。
akousa.net Developer API 的变更、改进和新功能的时间线记录。
所有 v1 响应现在都包含 X-API-Version: 1.0.0 响应头。客户端可使用此响应头验证是哪个 API 版本提供了响应,并在集成中实现版本感知逻辑。
端点现在可以通过符合 RFC 8594 的 Deprecation、Sunset 和 Link 响应头来发出弃用信号。当端点计划移除时,Deprecation 响应头指示弃用日期,Sunset 响应头指示移除日期,Link 响应头指向替代端点的文档。
现在所有错误响应都会返回一致的 { ok: false, error, code?, status } 结构。旧版的 { error } 结构已弃用,并将在未来版本中移除。成功响应将继续返回 { ok: true, data, ... }。这种统一简化了全部 83 个端点上的客户端错误处理。
发布了 akousa.net 开发者 API,包含分布于 17 个分组的 83 个端点、完整的 OpenAPI 3.1 规范、随 Akousa Pro 提供的 API 访问权限、使用 ak_ 前缀的 API 密钥认证,以及带分级每日配额的速率限制。交互式文档提供 8 种语言的代码示例(cURL、JavaScript、Python、Go、PHP、Ruby、Java、C#)。