[英]Cannot get combined envelope document with SBS signatures
I'm trying to query for the combined Envelope document (all envelopes and certificate as one PDF).我正在尝试查询合并的信封文档(所有信封和证书作为一个 PDF)。 For this I'd use the EnvelopeDocuments interface, specifically via get request.为此,我将使用 EnvelopeDocuments 接口,特别是通过获取请求。 But that responds me with an Error I do not know how to interpret.但这以我不知道如何解释的错误回应我。
Usually I'd make a REST-request from Java, but to rule out most errors I'm using the docusign API Explorer :通常我会从 Java 发出 REST 请求,但为了排除大多数错误,我使用的是文档API Explorer :
After entering the parameters the API explorer gives the url /restapi/v2.1/accounts/7f[...]/envelopes/A5AAACA-[...]/documents/combined
, but the request just returns a 400 with following data:输入参数后 API 资源管理器给出 url /restapi/v2.1/accounts/7f[...]/envelopes/A5AAACA-[...]/documents/combined
,但请求仅返回 400 和以下数据:
{
"message" : "Bad Request",
"response" : {
"type": "Buffer",
"data": [123, 34, ...]
}
}
When I use certificate
or some document-id instead of combined
the api responds with the certificate or the document, as expected.当我使用certificate
或某些文档 ID 而不是combined
时,api 按预期响应证书或文档。
What am I doing wrong?我究竟做错了什么? And How do I interpret the response-data being a byte-buffer?以及如何将响应数据解释为字节缓冲区? Usually error responses should contain a code and a message, but not more?通常错误响应应该包含代码和消息,但不是更多?
EDIT:编辑:
Actually, making a custom rest-request instead of using the api explorer gave me more insight with a Proper error message:实际上,制作自定义休息请求而不是使用 api 资源管理器让我更深入地了解了正确的错误消息:
{
"errorCode": "COMBINED_PDF_DOWNLOAD_NOT_ALLOWED",
"message": "Setting Enable Combined PDF Download for SBS envelopes is turned off"
}
So, apparently I can not download a combined PDF, as the envelope was signed with a Qualified Electronic Signature.因此,显然我无法下载组合的 PDF,因为信封已使用合格的电子签名进行签名。
But can I turn on combined download somehow?但是我可以以某种方式打开组合下载吗? I could not find anything in the settings.我在设置中找不到任何东西。
By design, you can't download a "combined" documents and certificate of completion PDF when the documents include a standards-based signature (SBS).根据设计,当文档包含基于标准的签名 (SBS) 时,您无法下载“组合”文档和完成证书 PDF。
SBS signatures are digital X.509 signatures. SBS 签名是数字 X.509 签名。 That type of signature, by itself, guarantees both the identity of the signer and the integrity of the signed document.这种类型的签名本身就保证了签名者的身份和签名文档的完整性。
If DocuSign created a combined PDF that included the SBS-signed document, then that document's SBS signatures would no longer be valid: not good.如果 DocuSign 创建了包含 SBS 签名文档的组合 PDF,那么该文档的 SBS 签名将不再有效:不好。
Combined PDF Download is a feature that you need to enable with the DocuSign support, you need to submit a case on their portal at https://support.docusign.com and request to enable this feature.组合 PDF 下载是您需要启用 DocuSign 支持的功能,您需要在其门户网站上提交案例https://support.docusign.Z4D236D9A2D102C5FE6AD1C50DA4BEC50并请求启用此功能。
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.