如何配置SoapUI对接DocuSign REST服务并调用指定登录接口
用SoapUI对接DocuSign REST服务并调用登录接口
嘿,我来一步步给你拆解怎么搞定这个事儿,先提前确认两件事:你已经有DocuSign demo环境的开发者账号,而且SoapUI已经安装就绪了哈。
一、准备必要的DocuSign认证信息
你得先拿到这三个关键信息,缺一不可:
- 集成密钥(Integration Key):在DocuSign开发者后台(demo环境)创建应用时生成的一串字符。
- DocuSign邮箱账号:你登录demo.docusign.net用的邮箱。
- DocuSign登录密码:对应上述邮箱的登录密码。
二、在SoapUI中创建REST项目
- 打开SoapUI,点击左上角的
File->New REST Project。 - 在弹出的对话框里,输入登录接口的URL:
https://demo.docusign.net/restapi/v2/login_information,然后点击OK。这时候SoapUI会自动帮你生成一个基础的REST项目结构。
三、配置认证(最关键的一步!)
DocuSign的REST服务支持多种认证方式,针对登录接口,用Basic Auth最直接:
- 在左侧的项目树里,找到刚创建的项目,右键点击
Default Request,选择Show Request Editor。 - 在请求编辑器底部,切换到
Auth标签页。 - 点击
Add New Authorization,选择Basic类型。 - 在配置框里填好以下内容:
- Username:格式必须是
你的邮箱@域名.com?integrator_key=你的集成密钥,比如john.doe@example.com?integrator_key=123456-abcdef-ghijkl - Password:输入你的DocuSign登录密码
- 一定要勾选
Authenticate Preemptively,这样SoapUI会自动在请求头里带上认证信息,不用手动折腾。
- Username:格式必须是
- 点击
OK保存配置。
四、发送登录请求并查看响应
- 回到请求编辑器的
Request标签页,确认请求方法是GET(这个接口只接受GET请求,别选错了)。 - 如果你需要额外的返回字段,可以在URL后拼接参数,比如:
- 要返回API密码,就加
?api_password=true - 要返回账号GUID,就加
?include_account_id_guid=true
最终URL可能变成https://demo.docusign.net/restapi/v2/login_information?api_password=true
- 要返回API密码,就加
- 点击右上角的
Send按钮,发送请求。 - 切换到底部的
Response标签页,你会看到包含账号信息、baseUrl等的JSON响应,这就说明调用成功啦!
五、常见问题排查
- 401 Unauthorized:先检查Username的格式是不是完全正确,特别是
?integrator_key=xxx的后缀不能少;然后核对集成密钥、邮箱、密码有没有输错。 - 400 Bad Request:确认请求方法是
GET,这个接口不接受POST/PUT等其他方法。 - 请求超时/无法连接:检查你的网络是否能访问demo.docusign.net,可能是代理或防火墙拦截了请求。
内容的提问来源于stack exchange,提问作者T_Gallant
相关产品推荐
相关产品推荐

