You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
81 lines
3.6 KiB
81 lines
3.6 KiB
package common.ecommerce.hengjian; |
|
|
|
/** |
|
* 恒健(HengJian / Efulfill)协议常量。 |
|
* |
|
* <p>端点与路径是<b>协议的一部分</b>,写在代码里,不做成配置表。 |
|
* 运行时不使用 {@link #TEST_BASE_URL}:端点由调用方每次经 |
|
* {@code WarehouseConnection} 传入。</p> |
|
* |
|
* <p>依据恒健语雀《OpenAPI接口文档》(book tvzvkk,2026-11 核对)。 |
|
* 该文档单篇接口页里<b>没有</b>写鉴权细节,鉴权只在《基础API调用》一页, |
|
* 且写了两个都叫「授权Token」的请求头。</p> |
|
*/ |
|
public final class HengjianConstants { |
|
|
|
/** 适配器标识。 */ |
|
public static final String ADAPTER_ID = "hengjian"; |
|
|
|
/** |
|
* 测试 / 联调环境基址。 |
|
* |
|
* <p>文档写的是 {@code https://pr-open-api.ehengjian.com},末尾不带斜杠, |
|
* 与 {@code WarehouseConnection} 的归一化一致,路径直接以 {@code /} 开头拼接。</p> |
|
*/ |
|
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}。 |
|
* |
|
* <p>文档把 {@code Authorization} 与 {@code x-api-key} 两个头都标成「授权Token」, |
|
* 且都标「必须」,所以两个都带、取值相同(复用 {@code ChannelSecret.appSecret()})。</p> |
|
* |
|
* <p><b>真机尚不能确认是否可以只带一个</b>:用一个无效 token 试过, |
|
* 只带一个和两个都带都返回 500「未知的账户!」,区分不出是哪个头在起作用。 |
|
* 拿到有效 token 后应补一次对照实验,再决定能否精简。</p> |
|
*/ |
|
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; |
|
|
|
/** |
|
* 未授权 / 未知账户的业务码。 |
|
* |
|
* <p><b>真机观察</b>(2026-11-12,测试环境):不带任何授权头请求 |
|
* {@code /v2/warehouse/getWarehouse},HTTP 仍是 <b>200</b>,body 是 |
|
* {@code {"statusCode":500,"status":1,"code":999999,"message":"查询失败Unauthorized"}}。 |
|
* 带上任意一个头(值无效)时则返回 Spring 的 500 错误页 |
|
* {@code {"status":500,...,"message":"未知的账户!"}}。</p> |
|
* |
|
* <p>因此这个码必须按<b>认证失败</b>处理,不能当普通业务失败——否则宿主只会看到 |
|
* 一条「业务码非 200」,不会去刷新凭据。</p> |
|
*/ |
|
public static final int UNAUTHORIZED_CODE = 999999; |
|
|
|
/** |
|
* 限流:每秒许可数。 |
|
* |
|
* <p>恒健文档未公开限流值,先按三家仓的保守默认 2 req/s/仓;联调确认后只改这一处。</p> |
|
*/ |
|
public static final int PERMITS_PER_SECOND = 2; |
|
|
|
private HengjianConstants() { |
|
} |
|
}
|
|
|