包信息
| 属性 | 值 |
|---|---|
| NuGet 包 | Bitzsoft.Integrations.Express.Cainiao |
| Provider ID | cainiao |
| 鉴权 | 对接码（AppKey）+ 签名密钥（AppSecret） |
| 协议 | 菜鸟速递 EDI |
配置字段（CainiaoOptions）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
AppKey | string | 是 | — | 菜鸟侧对接码（logistic_provider_id） |
AppSecret | string | 是 | — | 签名密钥 |
BaseUrl | string | 否 | https://edi-daily.xpm.cainiao.com | EDI API 基地址（测试网关） |
HttpClientName | string | 否 | CainiaoExpress | 命名 HttpClient |
配置示例
{ "Express": { "Cainiao": { "AppKey": "your-logistic-provider-id", "AppSecret": "your-sign-secret", "BaseUrl": "https://edi-daily.xpm.cainiao.com" } }}DI 注册
builder.Services.AddBitzsoftCainiaoExpress(builder.Configuration.GetSection("Express:Cainiao"));使用示例
public class CainiaoService(IExpressProvider express){ public async Task<ExpressTrackingInfo> TrackAsync(string trackingNumber) { return await express.TrackAsync(trackingNumber); }
public async Task<ExpressShipmentResult> CreateShipmentAsync(ShipmentRequest req) { return await express.CreateShipmentAsync(req); }}已知限制
BaseUrl默认为测试网关，生产环境需替换。- EDI 协议要求参数签名（基于
AppSecret），实现内部处理。