DocuSign API调用返回错误码200：Appian集成调用Send Document For eSignature失败

首先明确：HTTP 200 仅代表请求已经成功送达DocuSign服务端，业务逻辑层面的错误信息会封装在响应体中，你可以按以下步骤逐一排查：

• 第一步优先导出接口完整响应报文，定位报文中的errorDetails字段，该字段会明确返回业务错误的具体代码和说明，是排查问题的核心依据。常见的业务错误包括参数缺失、权限不足、资源超限三类。
• 校验接口入参合法性：
  • 上传的签署文件需符合DocuSign格式要求，仅支持PDF、DOC、DOCX、PNG等常见格式，单文件大小不超过25MB，文件名不能包含<>、/这类特殊字符
  • 签署人信息至少配置1条有效记录，邮箱格式、姓名不得为空
  • 信封状态参数需设置为sent，如果配置为created只会创建草稿信封，不会触发发送流程
• 校验集成权限配置：
  • 你创建的DocuSign连接系统OAuth授权需包含signature、impersonation两个必填权限范围，缺少签名权限会直接导致发送接口业务报错
  • 确认当前授权的DocuSign账号有信封发送权限，沙箱环境需要检查账号是否激活、是否还有剩余的发送额度
• 校验Appian侧配置：
  • 确认所用的DocuSign集成组件版本和当前Appian平台版本兼容，低版本组件存在参数序列化异常的已知问题
  • 查看Appian后台运行日志，排查是否存在请求超时、参数加密失败类的异常记录

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