包信息
| 属性 | 值 |
|---|---|
| NuGet 包 | Bitzsoft.Integrations.Express.ChinaPost |
| Provider ID | chinapost |
| 鉴权 | 协议客户号（SenderNo）+ 授权码（Authorization） |
| 能力 | 全功能 |
配置字段（ChinaPostOptions）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
SenderNo | string | 是 | — | 协议客户号 |
Authorization | string | 是 | — | 授权码（区分测试和生产） |
BaseUrl | string | 否 | https://api.ems.com.cn | API 基地址 |
HttpClientName | string | 否 | ChinaPostExpress | 命名 HttpClient |
UserCode | string? | 否 | — | 用户编码 |
Version | string | 否 | V1.0.0 | EMS API 版本 |
配置示例
{ "Express": { "ChinaPost": { "SenderNo": "your-sender-no", "Authorization": "your-auth-code", "Version": "V1.0.0" } }}DI 注册
builder.Services.AddBitzsoftChinaPostExpress(builder.Configuration.GetSection("Express:ChinaPost"));使用示例
public class ChinaPostService(IExpressProvider express){ public async Task CancelAsync(string orderId) { await express.CancelShipmentAsync(orderId); }}已知限制
Authorization授权码区分测试和生产环境，切换环境需替换。- API 版本默认
V1.0.0，不同版本字段定义可能有差异。