DocuSign - 随机 UNABLE_TO_CONVERT_DOCUMENT 错误

Question

我正在使用 Docusign 创建信封 API，使用端点 https://au.docusign.net/restapi/v2/accounts/{AccountID}/envelopes。 API 调用适用于大多数情况，但有时我会收到一条错误消息，指出系统无法将此文档转换为 PDF。我正在提交一个随机失败的 docx 类型文档（比如一天一次）。在重新提交时，相同的文件提交工作没有任何问题。

为了了解问题，我尝试启用 DocuSign 登录。由于日志在任何给定时间最多只能保留 50 个条目，因此我正在清除日志以确保我准备好在故障发生时捕获它。

收到的实际错误消息：

{
  "errorCode": "UNABLE_TO_CONVERT_DOCUMENT",
  "message": "System was unable to convert this document to a PDF. Unable to convert Document(Document Name.docx) to a PDF. Error: UserId:{GUID} IPAddress:XX.XX.XXX.XXX Source:ApiRESTv2:Failed to convert FileType: docx"
}

现在我正在尝试通过 DocuSign UI 下载日志文件，但在尝试这样做时我收到了持续的超时问题。有人知道从 DocuSign 提取的任何程序日志文件吗？以前有人做过吗？

非常感谢任何有关错误解决方案或帮助下载错误日志的指针。请帮忙

Answer 1

DocuSign 平台默认接受 PDF 文档，因此在通过 API 发送时，您只需包含 PDF 的文档字节。但是对于任何其他文件格式，您需要将文档对象上的 fileExtension 属性设置为您要发送的文件类型。

例如，如果使用其中一个开源 DocuSign SDK 使用 setFileExtension() 设置方法来设置扩展：

document.setFileExtension("docx");

或者，如果您直接调用 REST API（即不使用 SDK），则将 fileExtension 属性设置为“docx”：

{
    ...
    "fileExtension": "docx",
    ....
}

如果您在此之后仍然收到错误，那么您将开始使用不同的文档进行测试，并确认您使用的文档没有以任何方式损坏并且格式正确。