Docusign:无法从restapi v2中的文档创建信封

Question

我们正试图使用docusign restapi v2从pdf文档创建一个信封。我们可以使用XML创建信封，但当我们尝试使用JSON时，我们从docusign收到以下错误。

"errorCode": "ENVELOPE_IS_INCOMPLETE",
"message": "The Envelope is not Complete. A Complete Envelope Requires Documents, Recipients, Tabs, and a Subject Line. Envelope definition missing."

下面是fiddler发送的整个POST（删除了文件内容）。

POST https://demo.docusign.net/restapi/v2/accounts/xxxxx/envelopes HTTP/1.1
X-DocuSign-Authentication: {"Username":"xxxxxx","Password":"xxxxx","IntegratorKey":"xxxxxx"}
Content-Type: multipart/form-data; boundary=AAA
Accept: application/json
Host: demo.docusign.net
Content-Length: 90500
Expect: 100-continue

--AAA
Content-Type: application/json
Content-Disposition: form-data
{
  "emailBlurb": "Blurb",
  "emailSubject": "Subhject",
  "documents": [
    {
      "name": "NDA.pdf",
      "documentId": "1"
    }
  ],
  "recipients": {
    "signers": [
      {
        "tabs": {
          "signHereTabs": [
            {
              "pageNumber": "1",
              "yPosition": "1",
              "xPosition": "1",
              "documentId": "1",
              "tabId": "1",
              "name": "TabName"
            }
          ]
        },
        "routingOrder": "1",
        "recipientId": "1",
        "name": "Ben",
        "email": "[e-mail]"
      }
    ]
  },
  "status": "created"
}
--AAA
Content-Type: application/pdf
Content-Disposition: file; filename="NDA.pdf"; documentId="1"
<pdf file image content goes here>
    --AAA--

据我所知，JSON看起来是正确的。我们这里有什么不对劲的地方吗？

Answer 1

您的JSON看起来不错，这可能是因为您在请求体中有一两个额外的CRLF字符分隔边界。一般来说，这就是事物需要间隔的方式（每条换行符都是\r\n）：

--AAA
Content-Type: application/json
Content-Disposition: form-data
<YOUR VALID JSON GOES HERE>
--AAA
Content-Type:application/pdf
Content-Disposition: file; filename="document.pdf"; documentid=1 
<DOCUMENT BYTES GO HERE>
--AAA--

很可能是文档字节后的额外换行导致了您的问题。

Answer 2

我也有同样的问题症状。

我的问题是"边界终结者"。请务必使用：

--AAA
Content-Type: application/json
Content-Disposition: form-data
<YOUR VALID JSON GOES HERE>
--AAA--

如果您的多部分附件中没有文档