Bitzsoft.Integrations.Express.Zto
1.0.0-alpha.8
This is a prerelease version of Bitzsoft.Integrations.Express.Zto.
dotnet add package Bitzsoft.Integrations.Express.Zto --version 1.0.0-alpha.8
NuGet\Install-Package Bitzsoft.Integrations.Express.Zto -Version 1.0.0-alpha.8
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Bitzsoft.Integrations.Express.Zto" Version="1.0.0-alpha.8" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Bitzsoft.Integrations.Express.Zto" Version="1.0.0-alpha.8" />
<PackageReference Include="Bitzsoft.Integrations.Express.Zto" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Bitzsoft.Integrations.Express.Zto --version 1.0.0-alpha.8
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Bitzsoft.Integrations.Express.Zto, 1.0.0-alpha.8"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Bitzsoft.Integrations.Express.Zto@1.0.0-alpha.8
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Bitzsoft.Integrations.Express.Zto&version=1.0.0-alpha.8&prerelease
#tool nuget:?package=Bitzsoft.Integrations.Express.Zto&version=1.0.0-alpha.8&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Bitzsoft.Integrations.Express.Zto
中通快递物流服务实现,面向中通开放平台提供物流轨迹查询接入结构。
功能特性
- 基于中通开放平台 API,支持物流轨迹查询
- 认证方式:AppKey + AppSecret(HMAC-SHA256 签名)
- 对接流程:注册用户 → 资质认证 → 创建应用 → 添加服务 → 联调测试 → 上线
安装
dotnet add package Bitzsoft.Integrations.Express.Zto
<PackageReference Include="Bitzsoft.Integrations.Express.Zto" Version="*" />
配置
{
"Express": {
"Zto": {
"AppKey": "你的AppKey",
"AppSecret": "你的AppSecret",
"BaseUrl": "https://jwzto.zto.com",
"HttpClientName": "ZtoExpress"
}
}
}
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
AppKey |
是 | — | 中通开放平台 AppKey |
AppSecret |
是 | — | 中通开放平台 AppSecret |
BaseUrl |
否 | https://jwzto.zto.com |
API 基地址 |
HttpClientName |
否 | ZtoExpress |
命名 HttpClient 名称 |
注册服务
services.AddBitzsoftZtoExpress(configuration, "Express:Zto");
第三方请求日志
内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道,默认 NullRequestLogStore 不持久化。
// ① 默认:启用记录管道但不持久化(日志丢弃)
services.AddBitzsoftZtoExpress(options => { /* ... */ });
// ② 持久化:宿主注册 IRequestLogStore 实现后,所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
opts.MaxBodyLength = 8192;
opts.SensitiveFields.Add("mySecret");
});
services.AddBitzsoftZtoExpress(options => { /* ... */ });
能力范围
| 能力 | 说明 |
|---|---|
| 物流轨迹查询 | 按中通开放平台应用权限调用轨迹查询接口 |
| 认证签名 | 使用 AppKey 与 AppSecret 生成请求签名 |
| 扩展接口 | 可按已开通服务继续扩展寄件、取消、订阅等能力 |
注意事项
- 中通开放平台(https://open.zto.com/)需完成企业注册、资质认证、创建应用等流程
- 接口文档和服务权限以中通开放平台应用开通结果为准
相关包
| 包名 | 说明 |
|---|---|
| Bitzsoft.Integrations.Express | 抽象层 |
| Bitzsoft.Integrations.Express.All | 聚合包 |
| Bitzsoft.Integrations.Compatibility | 基础工具库 |
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 is compatible. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- Bitzsoft.Integrations.Compatibility (>= 1.0.0-alpha.8)
- Bitzsoft.Integrations.Express (>= 1.0.0-alpha.8)
- Bitzsoft.Integrations.RequestLogging (>= 1.0.0-alpha.8)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Http (>= 10.0.9)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.9)
-
net5.0
- Bitzsoft.Integrations.Compatibility (>= 1.0.0-alpha.8)
- Bitzsoft.Integrations.Express (>= 1.0.0-alpha.8)
- Bitzsoft.Integrations.RequestLogging (>= 1.0.0-alpha.8)
- Microsoft.Extensions.Configuration.Abstractions (>= 5.0.0)
- Microsoft.Extensions.Http (>= 5.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 5.0.0)
-
net8.0
- Bitzsoft.Integrations.Compatibility (>= 1.0.0-alpha.8)
- Bitzsoft.Integrations.Express (>= 1.0.0-alpha.8)
- Bitzsoft.Integrations.RequestLogging (>= 1.0.0-alpha.8)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Http (>= 10.0.9)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.9)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Bitzsoft.Integrations.Express.Zto:
| Package | Downloads |
|---|---|
|
Bitzsoft.Integrations.Express.All
快递物流服务聚合包 — 包含所有供应商实现 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.0-alpha.8 | 46 | 7/1/2026 |
| 1.0.0-alpha.7 | 62 | 6/16/2026 |
| 1.0.0-alpha.6 | 63 | 6/16/2026 |
| 1.0.0-alpha.5 | 58 | 6/14/2026 |
| 1.0.0-alpha.3 | 57 | 6/7/2026 |