包信息
| 属性 | 值 |
|---|---|
| NuGet 包 | Bitzsoft.Integrations.Express.Kdniao |
| Provider ID | kdniao |
| 鉴权 | EBusinessId + AppKey |
| 能力 | 物流轨迹查询 + 订阅推送 |
配置字段（KdniaoOptions）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
EBusinessId | string | 是 | — | 商户 ID |
AppKey | string | 是 | — | 应用密钥 |
BaseUrl | string | 否 | https://api.kdniao.com/api/ | API 基地址 |
HttpClientName | string | 否 | KdniaoExpress | 命名 HttpClient |
配置示例
{ "Express": { "Kdniao": { "EBusinessId": "your-merchant-id", "AppKey": "your-app-key" } }}DI 注册
builder.Services.AddBitzsoftKdniaoExpress(builder.Configuration.GetSection("Express:Kdniao"));使用示例
public class KdniaoService(IExpressProvider express){ public async Task<ExpressSubscriptionResult> SubscribeAsync(string trackingNumber, string callbackUrl) { return await express.SubscribeAsync(trackingNumber, callbackUrl); }}已知限制
- 快递鸟分即时查询 API 和订阅推送 API，两者计费方式不同。
CreateShipmentAsync等下单能力快递鸟需企业版权限。