DocuSign将Webhook连接到。净核心3

Question

我正在创建一个webhook。Net Core 3 Web API，用于DocuSign Connect调用并向我提供状态更新我的应用程序创建的信封中的签名文档。C#示例位于https://www.docusign.com/blog/dsdev-adding-webhooks-application这对我几乎达到目标很有帮助。示例中的代码是：

[HttpPost("api/[controller]/ConnectWebHook")]
public void ConnectWebHook(HttpRequestMessage request)
{
    XmlDocument xmldoc = new XmlDocument();
    xmldoc.Load(request.Content.ReadAsStreamAsync().Result);

    var mgr = new XmlNamespaceManager(xmldoc.NameTable);
    mgr.AddNamespace("a", "http://www.docusign.net/API/3.0");

    XmlNode envelopeStatus = xmldoc.SelectSingleNode("//a:EnvelopeStatus", mgr);
    XmlNode envelopeId = envelopeStatus.SelectSingleNode("//a:EnvelopeID", mgr);
    XmlNode status = envelopeStatus.SelectSingleNode("./a:Status", mgr);

    var targetFileDirectory = @"\\my-network-share\";

    if (envelopeId != null)
    {
        System.IO.File.WriteAllText($"{targetFileDirectory}{envelopeId.InnerText}_{status.InnerText}_.xml", xmldoc.OuterXml);
    }

    if (status.InnerText == "Completed")
    {
        // Loop through the DocumentPDFs element, storing each document.

        XmlNode docs = xmldoc.SelectSingleNode("//a:DocumentPDFs", mgr);
        foreach (XmlNode doc in docs.ChildNodes)
        {
            string documentName = doc.ChildNodes[0].InnerText; // pdf.SelectSingleNode("//a:Name", mgr).InnerText;
            string documentId = doc.ChildNodes[2].InnerText; // pdf.SelectSingleNode("//a:DocumentID", mgr).InnerText;
            string byteStr = doc.ChildNodes[1].InnerText; // pdf.SelectSingleNode("//a:PDFBytes", mgr).InnerText;

            System.IO.File.WriteAllText($"{targetFileDirectory}{envelopeId.InnerText}_{documentId}_{documentName}", byteStr);
        }
    }
}

出于测试目的，我的网络应用编程接口允许所有来源并通过NGROK暴露给外部世界，我可以命中其他测试endpoint（GET和POST），但出于某种原因，当有值得通知的事件时，连接不会命中此网络钩子在我的信封上。

我可以在DocuSSignAdmin门户日志中看到Connect调用了我的webook，但远程服务器返回了一个错误：（415）不支持的媒体类型...这导致我将[FromBody]属性添加到我的方法签名中，就像这样，但是当Connect调用我的网络钩子时，我仍然会得到同样的错误。

[HttpPost("api/[controller]/ConnectWebHook")]
public void ConnectWebHook([FromBody] HttpRequestMessage request)
{
    // ... rest of the method was unchanged, removed for brevity
}

我以前从未使用过HttpRequestMessage，但它看起来很简单。我在DocuSign管理门户日志中注意到，Connect试图发送到webhook的数据只是XML。我可以尝试更改webhook的签名，以查找XmlDocument而不是HttpRequestMessage，但我不确定我会错过什么。

最近有人通过网络钩子集成了连接吗？你能让HttpquiestMessage为你工作吗？

于2019年10月18日添加：

DocuSign提到内容类型是XML。以下是内容的外观：

<DocuSignEnvelopeInformation 
    xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns="http://www.docusign.net/API/3.0">
  <EnvelopeStatus>...</EnvelopeStatus>
  <DocumentPDFs>...</DocumentPDFs>
</DocuSignEnvelopeInformation>

我已将AddXmlSerializerFormatters（）添加到Startup中的ConfigureServices方法中。cs。这个人。Net核心3，我必须像服务一样设置它。AddControllers（）。添加XMLSerializerFormatters（）而不是服务。AddMVC（）。AddXmlSerializerFormatters（）perhttps://docs.microsoft.com/en-us/aspnet/core/migration/22-to-30?view=aspnetcore-3.0

有了这个改变，我现在尝试使用[FromForm]像这样，我的webhook被点击了，但是请求输入参数基本上是空的<代码>请求。Content=null：

[HttpPost("api/[controller]/ConnectWebHook")]
public void ConnectWebHook([FromForm] HttpRequestMessage request)
{
    // ... rest of the method was unchanged, removed for brevity
}

由于请求是从DocuSign Connect发送的，因此我无法控制头/格式/内容。据我所知，他们没有提交XML对象，也没有提交表单，因此[FromForm]可能不是一种好方法。

Answer 1

该链接示例不适用于。净核心HttpRequestMessage不再是asp中的一等公民。net核心框架，并将作为正常模型处理。

只需直接从请求的正文中提取内容，其余内容应该能够保持与示例中相同。

[HttpPost("api/[controller]/ConnectWebHook")]
public IActionResult ConnectWebHook() {

    Stream stream = Request.Body;

    XmlDocument xmldoc = new XmlDocument();
    xmldoc.Load(stream);

    var mgr = new XmlNamespaceManager(xmldoc.NameTable);
    mgr.AddNamespace("a", "http://www.docusign.net/API/3.0");

    XmlNode envelopeStatus = xmldoc.SelectSingleNode("//a:EnvelopeStatus", mgr);
    XmlNode envelopeId = envelopeStatus.SelectSingleNode("//a:EnvelopeID", mgr);
    XmlNode status = envelopeStatus.SelectSingleNode("./a:Status", mgr);

    var targetFileDirectory = @"\\my-network-share\";

    if (envelopeId != null) {
        System.IO.File.WriteAllText($"{targetFileDirectory}{envelopeId.InnerText}_{status.InnerText}_.xml", xmldoc.OuterXml);
    }

    if (status.InnerText == "Completed") {
        // Loop through the DocumentPDFs element, storing each document.

        XmlNode docs = xmldoc.SelectSingleNode("//a:DocumentPDFs", mgr);
        foreach (XmlNode doc in docs.ChildNodes) {
            string documentName = doc.ChildNodes[0].InnerText; // pdf.SelectSingleNode("//a:Name", mgr).InnerText;
            string documentId = doc.ChildNodes[2].InnerText; // pdf.SelectSingleNode("//a:DocumentID", mgr).InnerText;
            string byteStr = doc.ChildNodes[1].InnerText; // pdf.SelectSingleNode("//a:PDFBytes", mgr).InnerText;

            System.IO.File.WriteAllText($"{targetFileDirectory}{envelopeId.InnerText}_{documentId}_{documentName}", byteStr);
        }
    }

    return Ok();
}