包信息
| 属性 | 值 |
|---|---|
| NuGet 包 | Bitzsoft.Integrations.Express.ShowApi |
| Provider ID | showapi |
| 鉴权 | AppId + MD5 签名（不再明文传输 AppSecret） |
| 能力 | 物流轨迹查询（聚合多家承运商） |
配置字段（ShowApiOptions）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
AppId | string | 是 | — | 应用 ID |
AppSecret | string | 是 | — | 应用密钥 |
BaseUrl | string | 否 | https://route.showapi.com | API 基地址 |
HttpClientName | string | 否 | ShowApiExpress | 命名 HttpClient |
鉴权与签名
每个请求需携带 showapi_appid、showapi_timestamp 与 showapi_sign 签名参数。签名按以下方式计算：
showapi_sign = MD5(AppId + 时间戳 + MD5(AppSecret).ToLower()).ToLower()不再明文传输 AppSecret，AppSecret 仅参与本地签名计算。
配置示例
{ "Express": { "ShowApi": { "AppId": "your-app-id", "AppSecret": "your-app-secret" } }}DI 注册
builder.Services.AddBitzsoftShowApiExpress(builder.Configuration.GetSection("Express:ShowApi"));使用示例
public class ShowApiService(IExpressProvider express){ public async Task<ExpressCarrierInfo> DetectAsync(string trackingNumber) { return await express.DetectCarrierAsync(trackingNumber); }}已知限制
- 万维易源是聚合 API 平台，通过统一接口查询多家承运商的物流轨迹，本身不是快递公司。
- 不支持下单/面单生成等操作——只实现查询相关方法。