DocuSign Connect调用WCF Rest端点的Content-Type配置问题

核心结论 #

DocuSign Connect的per-envelope类型Webhook（eventNotification）不支持自定义Content-Type请求头，它的Content-Type由指定的format参数固定对应：

• format=json → application/json
• format=xml → text/xml
• SOAP格式对应application/soap+xml等
  没有配置项能让它直接发送application/x-www-form-urlencoded格式的JSON负载。

针对WCF端点的适配方案 #

1. 修改WCF端点配置，支持接收application/json的Stream

你的现有WCF Stream参数端点默认只处理application/x-www-form-urlencoded请求，只需在WebInvoke属性中补充ContentType和RequestFormat配置，即可兼容DocuSign的JSON请求：

[OperationContract]
[WebInvoke(Method = "POST", 
           UriTemplate = "/PBSAPI", 
           ContentType = "application/json", 
           RequestFormat = WebMessageFormat.Json)]
Stream PBSAPI(Stream data);

修改后，WCF会正确接收application/json类型的请求体并传入Stream参数，你可以在方法内部读取Stream内容（JSON字符串），再自行反序列化为业务对象处理。

2. 解决string参数接收失败的问题

若改用string参数，由于DocuSign发送的是JSON对象而非单个字符串，WCF默认的JSON序列化逻辑会无法解析。此时可选择：

• 继续使用Stream参数，手动读取并转换为字符串；
• 定义与DocuSign Webhook payload结构匹配的实体类，直接用实体类作为参数，让WCF自动完成反序列化：

// 示例：匹配DocuSign Connect payload的实体类（需根据实际字段调整）
public class DocuSignWebhookPayload
{
    public string EnvelopeId { get; set; }
    public string Status { get; set; }
    // 其他DocuSign返回的字段...
}

[OperationContract]
[WebInvoke(Method = "POST", 
           UriTemplate = "/PBSAPI", 
           ContentType = "application/json", 
           RequestFormat = WebMessageFormat.Json)]
void PBSAPI(DocuSignWebhookPayload payload);

3. 代理层转换方案（若必须保留application/x-www-form-urlencoded要求）

如果你的WCF端点无法修改，可在前端增加一个轻量代理（比如ASP.NET Core API、Nginx反向代理）：

• 接收DocuSign的application/json请求；
• 将JSON内容封装为application/x-www-form-urlencoded格式的表单字段（例如payload={"envelopeId":"xxx",...}）；
• 转发修改后的请求到WCF端点。

内容的提问来源于stack exchange，提问作者Pavel