2014-05-15 35 views
0

似乎有两种方式我可以收集在信封上各个收件人的状态信息:检索通过REST API受援国地位

  1. GET - V2 /帐号/:帐户ID /信封/:envelopeId /收件人
  2. GET - V2 /帐号/:帐户ID /信封/:envelopeId/audit_events

不幸的是,每次从正在难以让我要么使用一个单独的限制,这些患有的。

  1. 该API调用返回两个感兴趣的DateTime值:deliveredDateTime和signedDateTime。我能够成功调用并使用此API。但是,在我看来,直到用户实际单击电子邮件链接并单击签署者视图上的审阅文档按钮时,才会指定deliverDateTime。由于我真正感兴趣的可能会更好地描述为sentDateTime,deliverDateTime似乎不适合我的需求。
  2. 此API调用返回信封上已发生的所有事件的详细列表,包括个人收件人状态更新。但是,数据格式是这样的,为了将结果数据返回给收件人,我必须对收件人姓名进行字符串匹配。我更愿意根据电子邮件进行匹配,或者更好的是使用recipientID,但“发送的邀请”和“已签名”的审核日志条目不包含这些字段。下面是一个例子(click here to view larger):

enter image description here

难道还有比这两个,我可以用其他的API调用?有没有办法在审计事件API调用中获取更多数据?

谢谢你在前进,

安德鲁

回答

0

我不相信有一种方式来获得额外的数据来自以来的DocuSign API文档(这是最新的)的audit_events调用指示调用有没有参数(除了URL中的envelopeId)。

我认为你坚持在userName值上进行字符串比较来识别/链接你的收件人,但是我想指出,一旦你这样做,你就可以通过第一个API调用链接到他们独特的recipientGuid你在这里突出显示。

例如,/audit_events API调用似乎可以实现您想要的功能,并具有所需的所有信息,但它通过其用户名识别收件人。如果您随后在同一信封呼叫并检查从/收件人 URI的响应,它包含了nameemailrecipientIdrecipientGuid每个并请在信封每个收件人。匹配用户名和你现在有权访问他们的ID等

所以最后我不相信有一个API调用来实现这一点,但你可以通过做一个字符串比较并结合来自您突出显示的API调用。

+0

我需要邀请日期和签名日期。只要各种输出列的格式保持不变,我的审计日志解析器就可以工作。但是,当用户在移动设备上登录时,信息列(通常在操作列等于“signed”时为空)包含“on mobile”。消息列中的这种变体可能会破坏我的解析器。为什么审计日志缺乏唯一的ID?或者,为什么收件人信息API缺少发送邀请的日期? – AEberhard

+0

如果通过API提供的当前功能不适合您的需求,请通过您的DocuSign客户经理登录更改/功能请求。 – Ergin