包信息

NuGet 包：Bitzsoft.Integrations.ElectronicSignature.AdobeSign
接口：IElectronicSignatureProvider
鉴权：OAuth2 Bearer Token
Provider ID：AdobeSign

配置

字段	类型	必填	默认值	说明
`BaseUrl`	string	否	`https://api.na1.adobesign.com/api/rest/v6`	分片地址（NA1 / EU1 / JP1 等）
`AccessToken`	string	是	—	OAuth2 Bearer 访问令牌
`ApiUserEmail`	string?	否	—	默认发起方邮箱（部分端点要求 X-API-User 头）
`Timeout`	TimeSpan	否	`00:00:30`	HTTP 请求超时
`HttpClientName`	string	否	`AdobeSignElectronicSignatureProvider`	命名 HttpClient 标识

{
  "AdobeSign": {
    "BaseUrl": "https://api.na1.adobesign.com/api/rest/v6",
    "AccessToken": "your-access-token",
    "ApiUserEmail": "sender@example.com"
  }
}

注册

using Bitzsoft.Integrations.ElectronicSignature.AdobeSign;

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

// 方式二：委托配置
services.AddBitzsoftAdobeSignElectronicSignature(options =>
{
    options.BaseUrl = "https://api.na1.adobesign.com/api/rest/v6";
    options.AccessToken = "your-access-token";
    options.ApiUserEmail = "sender@example.com";
});

使用示例

var createResult = await provider.CreateContractAsync(new SimpleContractRequest
{
    Title = "NDA",
    FileName = "nda.pdf",
    FileData = await File.ReadAllBytesAsync("nda.pdf"),
    SignerName = "Jane Smith",
    SignerPhone = "jane@example.com"
});

var contractId = createResult.Data!;
var detail = await provider.GetContractDetailAsync(contractId);
var viewUrl = await provider.GetContractViewUrlAsync(contractId);

鉴权机制

每个 API 请求通过 Authorization: Bearer {token} 头携带 OAuth2 访问令牌。
建议先调用 /baseUris 获取当前用户所在分片，再据此切换 BaseUrl。

已知限制

不包含 Token 自动刷新；调用方需自行管理令牌生命周期，过期后更新 AccessToken 配置值。