Bitzsoft.Integrations.ElectronicSignature.Qiyuesuo 1.0.0-alpha.10

Bitzsoft.Integrations.ElectronicSignature.Qiyuesuo

契约锁电子签章服务实现，基于契约锁开放平台 API。

功能特性

• 完整实现 IElectronicSignatureProvider：覆盖合同发起、详情、下载、查看、撤销、签署 URL、签署状态、印章、模板、回调验签全部统一方法
• MD5 签名鉴权：MD5(AppToken + AppSecret + timestamp + nonce)，签名通过 HTTP headers 传递
• 回调验签：用 AppSecret 对 payload 计算 MD5 后比对签名（不区分大小写）
• 扩展 API 端点：通过 QueryGetAsync/QueryPostAsync/QueryUploadAsync/QueryDownloadAsync 内部方法访问契约锁全部 75 个 API 端点

安装

dotnet add package Bitzsoft.Integrations.ElectronicSignature.Qiyuesuo

<PackageReference Include="Bitzsoft.Integrations.ElectronicSignature.Qiyuesuo" Version="1.0.0" />

配置

{
  "Qiyuesuo": {
    "AppToken": "your-app-token",
    "AppSecret": "your-app-secret",
    "BaseUrl": "https://openapi.qiyuesuo.com"
  }
}

注册服务

using Bitzsoft.Integrations.ElectronicSignature.Qiyuesuo;

// 方式一：IConfiguration（默认读取 "Qiyuesuo" 配置节）
services.AddBitzsoftQiyuesuoElectronicSignature(configuration);

或：

using Bitzsoft.Integrations.ElectronicSignature.Qiyuesuo;

// 方式二：委托配置
services.AddBitzsoftQiyuesuoElectronicSignature(options =>
{
    options.AppToken = "your-app-token";
    options.AppSecret = "your-app-secret";
    options.BaseUrl = "https://openapi.qiyuesuo.com";
});

请求审计

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认 NullRequestLogStore 不持久化。

// ① 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftQiyuesuoElectronicSignature(configuration);

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("AppSecret");
});
services.AddBitzsoftQiyuesuoElectronicSignature(configuration);

使用示例

统一抽象

// 注入 IElectronicSignatureProvider，ProviderName == "Qiyuesuo"
var createResult = await provider.CreateContractAsync(new SimpleContractRequest
{
    Title = "采购合同",
    FileName = "contract.pdf",
    FileData = await File.ReadAllBytesAsync("contract.pdf"),
    SignerName = "张三",
    SignerPhone = "13800000000"
});

var contractId = createResult.Data!;

// 查询签署状态、下载合同
var status = await provider.GetSigningStatusAsync(contractId);
var bytes  = await provider.DownloadContractAsync(contractId);

扩展 API（partial class）

统一接口仅覆盖极简场景，复杂操作通过 QiyuesuoElectronicSignatureProvider 的 partial class 方法或内部 QueryPostAsync 调用：

var qys = (QiyuesuoElectronicSignatureProvider)provider;

// 通用 POST 查询，可访问契约锁全部 75 个端点
var result = await qys.QueryPostAsync(QiyuesuoApis.SealList, new { companyId = "org-id" });

覆盖端点分组：合同管理（22）、签署服务（14）、组织管理（13）、印章管理（10）、模板管理（8）、实名认证（7）、数据公证（5）、其他（7）。

核心类型一览

依赖

• Bitzsoft.Integrations.Compatibility：基础工具库
• Bitzsoft.Integrations.ElectronicSignature：统一抽象
• Bitzsoft.Integrations.RequestLogging：请求审计

相关包