如何启用 GZIP 压缩

轻松提速，现代化客户端几乎都支持

一、启用目的

为提升数据传输效率、降低网络带宽消耗以及优化双方系统交互的响应速度，针对我方开放的 API 接口，现要求所有接入客户启用 GZIP 压缩支持，以达成更高效的接口通信。

二、启用方法

接入方在发起所有 API 请求时，必须在 HTTP 请求头中添加以下配置：

Accept-Encoding: gzip

说明：该配置用于告知我方服务器，接入方系统支持接收 GZIP 压缩格式的响应数据。

三、建议启用 GZIP 的重点接口

以下两个接口因数据传输量较大，建议优先启用 GZIP 压缩以优化传输效率；若不配置，接口仍可正常返回数据，但数据传输体积较大，双方网络带宽消耗显著增加并且可能存在传输耗时较长的情况：

四、关键注意事项

动态压缩规则

我方服务器仅对响应体大小＞512 字节的数据进行 GZIP 压缩；响应体≤512 字节时，将返回原始未压缩数据，无需解压处理。

格式兼容要求

接入方需同时兼容「压缩」与「非压缩」两种响应格式，避免因数据格式不匹配导致解析失败。

压缩标识判断

当响应数据为 GZIP 压缩格式时，服务器会在响应头中返回标识：Content-Encoding: gzip，接入方可通过该字段判断是否需要解压。

五、接入提示

建议优先使用支持自动解压的 HTTP 客户端（如 Axios、OkHttp、浏览器原生 Fetch 等），此类工具可自动识别 Content-Encoding 头并完成解压，无需手动处理。
若使用自定义 HTTP 请求工具，需确保解压逻辑正确，避免因解压不完整导致数据解析异常。
接入后请针对上述两个强制接口进行专项测试，验证压缩 / 非压缩场景下的数据接收与解析正确性。