package common.ecommerce.hengjian; /** * 恒健(HengJian / Efulfill)协议常量。 * *

端点与路径是协议的一部分,写在代码里,不做成配置表。 * 运行时不使用 {@link #TEST_BASE_URL}:端点由调用方每次经 * {@code WarehouseConnection} 传入。

* *

依据恒健语雀《OpenAPI接口文档》(book tvzvkk,2026-11 核对)。 * 该文档单篇接口页里没有写鉴权细节,鉴权只在《基础API调用》一页, * 且写了两个都叫「授权Token」的请求头。

*/ public final class HengjianConstants { /** 适配器标识。 */ public static final String ADAPTER_ID = "hengjian"; /** * 测试 / 联调环境基址。 * *

文档写的是 {@code https://pr-open-api.ehengjian.com},末尾不带斜杠, * 与 {@code WarehouseConnection} 的归一化一致,路径直接以 {@code /} 开头拼接。

*/ public static final String TEST_BASE_URL = "https://pr-open-api.ehengjian.com"; /** 生产环境基址;运行时不使用,调用方需要时自己传。 */ public static final String PRODUCTION_BASE_URL = "https://open-api.ehengjian.com"; /** * 授权请求头 1:{@code Authorization}。 * *

文档把 {@code Authorization} 与 {@code x-api-key} 两个头都标成「授权Token」, * 且都标「必须」,所以两个都带、取值相同(复用 {@code ChannelSecret.appSecret()})。

* *

真机尚不能确认是否可以只带一个:用一个无效 token 试过, * 只带一个和两个都带都返回 500「未知的账户!」,区分不出是哪个头在起作用。 * 拿到有效 token 后应补一次对照实验,再决定能否精简。

*/ public static final String AUTHORIZATION_HEADER = "Authorization"; /** 授权请求头 2:{@code x-api-key};取值同 {@link #AUTHORIZATION_HEADER}。 */ public static final String API_KEY_HEADER = "x-api-key"; /** 获取当前组织仓库(无参数)。 */ public static final String PATH_WAREHOUSE_LIST = "/v2/warehouse/getWarehouse"; /** 获取物流渠道(无参数):全部承运商服务的扁平清单。 */ public static final String PATH_CARRIER_GROUP = "/v2/carrierGroup/getCarrierGroup"; /** 获取仓库支持的物流渠道:按仓代码过滤。 */ public static final String PATH_WAREHOUSE_CARRIER_GROUP = "/v2/carrierGroup/getWarehouseCarrierGroupServices"; /** 业务成功码;文档各接口一致写 {@code 200}。 */ public static final int SUCCESS_CODE = 200; /** * 未授权 / 未知账户的业务码。 * *

真机观察(2026-11-12,测试环境):不带任何授权头请求 * {@code /v2/warehouse/getWarehouse},HTTP 仍是 200,body 是 * {@code {"statusCode":500,"status":1,"code":999999,"message":"查询失败Unauthorized"}}。 * 带上任意一个头(值无效)时则返回 Spring 的 500 错误页 * {@code {"status":500,...,"message":"未知的账户!"}}。

* *

因此这个码必须按认证失败处理,不能当普通业务失败——否则宿主只会看到 * 一条「业务码非 200」,不会去刷新凭据。

*/ public static final int UNAUTHORIZED_CODE = 999999; /** * 限流:每秒许可数。 * *

恒健文档未公开限流值,先按三家仓的保守默认 2 req/s/仓;联调确认后只改这一处。

*/ public static final int PERMITS_PER_SECOND = 2; private HengjianConstants() { } }