我一般是docusign和api的新手。我已经在 docusign 上手动创建了一个主帐户,现在我想使用这个帐户创建新用户并使用代表发送功能。我已经浏览了这个 pdf ( http://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf )。但是任何人都可以用外行的方式解释我需要遵循的确切步骤是什么?谢谢
1 回答
2021 年 4 月更新
新的 REST API 集成既不支持 SOBO 也不支持旧式身份验证。相反,请使用 OAuth v2.0 身份验证授权。SOBO 模式的替代方法是使用 JWT 授权,它使应用程序能够模拟任何同意应用程序这样做的 DocuSign 用户。如果您有任何问题,请在 StackOverflow 上打开一个新的 q。
原始答案
请浏览DocuSign 开发中心,因为整个网站都有一些非常有用的信息,包括您正在寻找的确切 SOBO(代表发送)步骤。
转到开发中心 -> 探索 -> 功能 -> SOBO。一般来说,这些是您需要采取的步骤:
- 获取 User1(身份验证用户)的访问令牌
- 获取 User2 的访问令牌(操作用户 - 您代表此人发送)
- 代表 User2 发送请求
请参阅开发中心的此页面,了解要采取的确切步骤以及您需要打开的潜在帐户设置:
http://www.docusign.com/developer-center/explore/features/sobo
总结页面解释的内容并在这里也有答案,以下是详细信息:
步骤1:
POST https://{server}/restapi/{apiVersion}/oauth2/token
Accept: application/json
Content-Type: application/x-www-form-urlencoded
Content-Length: {length of body}
grant_type=password&client_id={IntegratorKey}&username={email}&password={password}&scope=api
确保在正文中提供您的帐户电子邮件、密码和集成商密钥。
成功的响应返回以下 JSON:
{
"access_token": "<access token for user>",
"scope": "api",
"token_type": "bearer"
}
第2步:
在此处添加标头Authorization: bearer <access_token>
,其中<access_token>
是步骤 1 中返回的令牌,电子邮件现在是您要代表发送的用户的电子邮件地址:
POST https://{server}/restapi/{apiVersion}/oauth2/token
Authorization: bearer <access token>
Accept: application/json
Content-Type: application/x-www-form-urlencoded
Content-Length: {length of body}
grant_type=password&client_id={IntegratorKey}&username={$emailOnBehalf}&password={password}&scope=api
结果是另一个访问令牌,假设它是 12345。
第 3 步:
现在,您可以在签名请求中使用以下身份验证标头代表该用户发送:
Authorization: bearer 12345
X-DocuSign-Act-As-User: $emailOnBehalf