DocuSign - 从 Java SDK listStatusChanges() 获取签名文档正文
DocuSign - Get signed documents body from Java SDK listStatusChanges()
我必须使用 EnvelopeAPI.listStatusChanges() 来轮询已签名的信封。它提供了一个对象 EnvelopeInfo，包含一个列表。
对于每个信封，我想检索已签名文档的正文，但 Envelope.getEnvelopeDocuments() 只是 return null.
ListStatusChangesOptions opt = api.new ListStatusChangesOptions();
opt.setFromDate(DateTimeFormatter.ISO_LOCAL_DATE_TIME.format(lastPoll.minusDays(1)));
EnvelopesInformation info = api.listStatusChanges(authService.getAccountId(),opt);
List<Envelope> envList = info.getEnvelopes();
assert (envList != null);
for (Envelope env : envList) {
String envId = env.getEnvelopeId());
String status = env.getStatus();
LocalDateTime changeTime = LocalDateTime.from(
DateTimeFormatter.ISO_DATE_TIME
.parse(env.getStatusChangedDateTime()));
System.out.format("%s: Changed status of \"%s\" in %s\n",
changeTime.toString(), envId(),status());
if (status.equals("completed")) {
List<EnvelopeDocument> documents = env.getEnvelopeDocuments();
assert(documents != null);
}
}
在示例中，对文档的最后断言总是失败。我做错了什么？
我得到的唯一相关日志是：
TraceToken: de41cfce-8a4d-4ef4-9a5f-a47659fa16fd
Timestamp: 2021-11-09T10:17:19.5448174Z
GET https://demo.docusign.net:7801/restapi/v2.1/accounts/<xxx>/envelopes?from_date=2021-11-08T11%3A14%3A13.8906278
Content-Length: 0
Connection: keep-alive
Accept: application/json
Authorization: Bearer [omitted]
Host: demo.docusign.net
User-Agent: Swagger-Codegen/3.15.0/java
X-DocuSign-SDK: Java
X-SecurityProtocol-Version: TLSv1.2
X-SecurityProtocol-CipherSuite: ECDHE-RSA-AES256-GCM-SHA384
x-forwarded-for: 93.34.235.164
200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 9671
X-DocuSign-TraceToken: de41cfce-8a4d-4ef4-9a5f-a47659fa16fd
{
"resultSetSize": "6",
"startPosition": "0",
"endPosition": "5",
"totalSetSize": "6",
"nextUri": "",
"previousUri": "",
"envelopes": [
{
"status": "completed",
"documentsUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/documents",
"recipientsUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/recipients",
"attachmentsUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/attachments",
"envelopeUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2",
"emailSubject": "Documents to sign",
"envelopeId": "fe3b2d69-1671-49cb-9af9-4186f0777ae2",
"signingLocation": "online",
"customFieldsUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/custom_fields",
"notificationUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-08T11:28:58.4730000Z",
"lastModifiedDateTime": "2021-11-08T11:28:58.4730000Z",
"deliveredDateTime": "2021-11-08T11:29:17.5000000Z",
"sentDateTime": "2021-11-08T11:28:59.0500000Z",
"completedDateTime": "2021-11-08T11:29:54.1470000Z",
"statusChangedDateTime": "2021-11-08T11:29:54.1470000Z",
"documentsCombinedUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/documents/combined",
"certificateUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/documents/certificate",
"templatesUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "sent",
"documentsUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/documents",
"recipientsUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/recipients",
"attachmentsUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/attachments",
"envelopeUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb",
"emailSubject": "Sottoscrizione Mario Rossi",
"emailBlurb": "Buongiorno,\ncome da accordi sono a inviarti la proposta di investimento da sottoscrivere.\nTi ricordo che la proposta ha una validità di 48 ore dalla data di consegna.\n\nCordiali saluti\n",
"envelopeId": "fb263fbd-6842-48fa-9665-03df9af2accb",
"signingLocation": "online",
"customFieldsUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/custom_fields",
"notificationUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T07:15:48.6970000Z",
"lastModifiedDateTime": "2021-11-09T07:17:00.6830000Z",
"sentDateTime": "2021-11-09T07:17:01.4670000Z",
"statusChangedDateTime": "2021-11-09T07:17:01.4670000Z",
"documentsCombinedUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/documents/combined",
"certificateUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/documents/certificate",
"templatesUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/templates",
"expireEnabled": "true",
"expireAfter": "2",
"sender": {
"userName": "Andrea Debortoli",
"userId": "xxx",
"accountId": "xxx",
"email": "andrea.debortoli@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "true",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "completed",
"documentsUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/documents",
"recipientsUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/recipients",
"attachmentsUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/attachments",
"envelopeUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7",
"emailSubject": "Documents to sign",
"envelopeId": "3d7130d7-b5bb-4579-9c25-f525c22064e7",
"signingLocation": "online",
"customFieldsUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/custom_fields",
"notificationUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T09:28:23.3930000Z",
"lastModifiedDateTime": "2021-11-09T09:28:23.3930000Z",
"deliveredDateTime": "2021-11-09T09:28:43.6400000Z",
"sentDateTime": "2021-11-09T09:28:23.9730000Z",
"completedDateTime": "2021-11-09T09:29:24.9800000Z",
"statusChangedDateTime": "2021-11-09T09:29:24.9800000Z",
"documentsCombinedUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/documents/combined",
"certificateUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/documents/certificate",
"templatesUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "completed",
"documentsUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/documents",
"recipientsUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/recipients",
"attachmentsUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/attachments",
"envelopeUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a",
"emailSubject": "Documents to sign",
"envelopeId": "99f3a387-f8e8-4763-9b50-3c2e49fc536a",
"signingLocation": "online",
"customFieldsUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/custom_fields",
"notificationUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T09:45:09.1130000Z",
"lastModifiedDateTime": "2021-11-09T09:45:09.1130000Z",
"deliveredDateTime": "2021-11-09T09:45:26.5430000Z",
"sentDateTime": "2021-11-09T09:45:10.0370000Z",
"completedDateTime": "2021-11-09T09:45:53.7670000Z",
"statusChangedDateTime": "2021-11-09T09:45:53.7670000Z",
"documentsCombinedUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/documents/combined",
"certificateUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/documents/certificate",
"templatesUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "completed",
"documentsUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/documents",
"recipientsUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/recipients",
"attachmentsUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/attachments",
"envelopeUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4",
"emailSubject": "Documents to sign",
"envelopeId": "864d7b45-e5a2-4188-a5c3-52693a2909c4",
"signingLocation": "online",
"customFieldsUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/custom_fields",
"notificationUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T09:58:49.7900000Z",
"lastModifiedDateTime": "2021-11-09T09:58:49.7900000Z",
"deliveredDateTime": "2021-11-09T09:59:06.0800000Z",
"sentDateTime": "2021-11-09T09:58:50.4330000Z",
"completedDateTime": "2021-11-09T09:59:37.2700000Z",
"statusChangedDateTime": "2021-11-09T09:59:37.2700000Z",
"documentsCombinedUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/documents/combined",
"certificateUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/documents/certificate",
"templatesUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "completed",
"documentsUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/documents",
"recipientsUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/recipients",
"attachmentsUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/attachments",
"envelopeUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce",
"emailSubject": "Documents to sign",
"envelopeId": "f01ef821-b29c-4747-804d-b379644b9bce",
"signingLocation": "online",
"customFieldsUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/custom_fields",
"notificationUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T10:14:16.2630000Z",
"lastModifiedDateTime": "2021-11-09T10:14:16.2800000Z",
"deliveredDateTime": "2021-11-09T10:14:36.8400000Z",
"sentDateTime": "2021-11-09T10:14:17.5300000Z",
"completedDateTime": "2021-11-09T10:15:11.1630000Z",
"statusChangedDateTime": "2021-11-09T10:15:11.1630000Z",
"documentsCombinedUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/documents/combined",
"certificateUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/documents/certificate",
"templatesUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
}
]
}
对 Envelope.getEnvelopeDocuments() 的调用似乎没有在任何 REST 调用中结束。我希望它在 Envelope.documentsUri 字段中包含的 URI 请求文档列表。我错了吗？
我不清楚 env.getEnvelopeDocuments() 在做什么。
您应该使用 EnvelopeDocuments:get API 方法。
这里是 code example 从 Java 调用 API 方法。
byte[] results = envelopesApi.getDocument(accountId, envelopeId, documentId);
要将所有文档合并为一个文档，请使用保留值 "combined" 作为 documentId。
为了检索文档信息，请求 属性 include 必须包含“文档”，如 [1] 中所述。从java SDK来看，对应call
listStatusChangesOptions.setInclude("documents,...");
... 说明您需要检索的任何其他详细信息类型（例如，在我的例子中，我还需要收件人列表，因此我设置“收件人、文件").
然后，在由请求编辑的信封对象 return 上，可以调用 getEnvelopeDocuments() 方法，其中 return 一个 Document 对象的列表.此类对象包含所有摘要信息，包括“documentUri”，格式如下：
/envelopes/c34c029d-1074-4h66-afe1-324b851397c4/documents/1
它连接到基本路径，正好构成 REST API 的 URL 以下载文档。换句话说，使用此 URI 或 EnvelopesApi.getDocument() 是完全相同的事情。
结论是没有办法下载文件，如果不从每小时可用的电话中至少计算一次的话
[1] https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopes/liststatuschanges/
我必须使用 EnvelopeAPI.listStatusChanges() 来轮询已签名的信封。它提供了一个对象 EnvelopeInfo，包含一个列表。 对于每个信封，我想检索已签名文档的正文，但 Envelope.getEnvelopeDocuments() 只是 return null.
ListStatusChangesOptions opt = api.new ListStatusChangesOptions();
opt.setFromDate(DateTimeFormatter.ISO_LOCAL_DATE_TIME.format(lastPoll.minusDays(1)));
EnvelopesInformation info = api.listStatusChanges(authService.getAccountId(),opt);
List<Envelope> envList = info.getEnvelopes();
assert (envList != null);
for (Envelope env : envList) {
String envId = env.getEnvelopeId());
String status = env.getStatus();
LocalDateTime changeTime = LocalDateTime.from(
DateTimeFormatter.ISO_DATE_TIME
.parse(env.getStatusChangedDateTime()));
System.out.format("%s: Changed status of \"%s\" in %s\n",
changeTime.toString(), envId(),status());
if (status.equals("completed")) {
List<EnvelopeDocument> documents = env.getEnvelopeDocuments();
assert(documents != null);
}
}
在示例中，对文档的最后断言总是失败。我做错了什么？
我得到的唯一相关日志是：
TraceToken: de41cfce-8a4d-4ef4-9a5f-a47659fa16fd
Timestamp: 2021-11-09T10:17:19.5448174Z
GET https://demo.docusign.net:7801/restapi/v2.1/accounts/<xxx>/envelopes?from_date=2021-11-08T11%3A14%3A13.8906278
Content-Length: 0
Connection: keep-alive
Accept: application/json
Authorization: Bearer [omitted]
Host: demo.docusign.net
User-Agent: Swagger-Codegen/3.15.0/java
X-DocuSign-SDK: Java
X-SecurityProtocol-Version: TLSv1.2
X-SecurityProtocol-CipherSuite: ECDHE-RSA-AES256-GCM-SHA384
x-forwarded-for: 93.34.235.164
200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 9671
X-DocuSign-TraceToken: de41cfce-8a4d-4ef4-9a5f-a47659fa16fd
{
"resultSetSize": "6",
"startPosition": "0",
"endPosition": "5",
"totalSetSize": "6",
"nextUri": "",
"previousUri": "",
"envelopes": [
{
"status": "completed",
"documentsUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/documents",
"recipientsUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/recipients",
"attachmentsUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/attachments",
"envelopeUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2",
"emailSubject": "Documents to sign",
"envelopeId": "fe3b2d69-1671-49cb-9af9-4186f0777ae2",
"signingLocation": "online",
"customFieldsUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/custom_fields",
"notificationUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-08T11:28:58.4730000Z",
"lastModifiedDateTime": "2021-11-08T11:28:58.4730000Z",
"deliveredDateTime": "2021-11-08T11:29:17.5000000Z",
"sentDateTime": "2021-11-08T11:28:59.0500000Z",
"completedDateTime": "2021-11-08T11:29:54.1470000Z",
"statusChangedDateTime": "2021-11-08T11:29:54.1470000Z",
"documentsCombinedUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/documents/combined",
"certificateUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/documents/certificate",
"templatesUri": "/envelopes/fe3b2d69-1671-49cb-9af9-4186f0777ae2/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "sent",
"documentsUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/documents",
"recipientsUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/recipients",
"attachmentsUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/attachments",
"envelopeUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb",
"emailSubject": "Sottoscrizione Mario Rossi",
"emailBlurb": "Buongiorno,\ncome da accordi sono a inviarti la proposta di investimento da sottoscrivere.\nTi ricordo che la proposta ha una validità di 48 ore dalla data di consegna.\n\nCordiali saluti\n",
"envelopeId": "fb263fbd-6842-48fa-9665-03df9af2accb",
"signingLocation": "online",
"customFieldsUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/custom_fields",
"notificationUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T07:15:48.6970000Z",
"lastModifiedDateTime": "2021-11-09T07:17:00.6830000Z",
"sentDateTime": "2021-11-09T07:17:01.4670000Z",
"statusChangedDateTime": "2021-11-09T07:17:01.4670000Z",
"documentsCombinedUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/documents/combined",
"certificateUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/documents/certificate",
"templatesUri": "/envelopes/fb263fbd-6842-48fa-9665-03df9af2accb/templates",
"expireEnabled": "true",
"expireAfter": "2",
"sender": {
"userName": "Andrea Debortoli",
"userId": "xxx",
"accountId": "xxx",
"email": "andrea.debortoli@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "true",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "completed",
"documentsUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/documents",
"recipientsUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/recipients",
"attachmentsUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/attachments",
"envelopeUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7",
"emailSubject": "Documents to sign",
"envelopeId": "3d7130d7-b5bb-4579-9c25-f525c22064e7",
"signingLocation": "online",
"customFieldsUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/custom_fields",
"notificationUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T09:28:23.3930000Z",
"lastModifiedDateTime": "2021-11-09T09:28:23.3930000Z",
"deliveredDateTime": "2021-11-09T09:28:43.6400000Z",
"sentDateTime": "2021-11-09T09:28:23.9730000Z",
"completedDateTime": "2021-11-09T09:29:24.9800000Z",
"statusChangedDateTime": "2021-11-09T09:29:24.9800000Z",
"documentsCombinedUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/documents/combined",
"certificateUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/documents/certificate",
"templatesUri": "/envelopes/3d7130d7-b5bb-4579-9c25-f525c22064e7/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "completed",
"documentsUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/documents",
"recipientsUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/recipients",
"attachmentsUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/attachments",
"envelopeUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a",
"emailSubject": "Documents to sign",
"envelopeId": "99f3a387-f8e8-4763-9b50-3c2e49fc536a",
"signingLocation": "online",
"customFieldsUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/custom_fields",
"notificationUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T09:45:09.1130000Z",
"lastModifiedDateTime": "2021-11-09T09:45:09.1130000Z",
"deliveredDateTime": "2021-11-09T09:45:26.5430000Z",
"sentDateTime": "2021-11-09T09:45:10.0370000Z",
"completedDateTime": "2021-11-09T09:45:53.7670000Z",
"statusChangedDateTime": "2021-11-09T09:45:53.7670000Z",
"documentsCombinedUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/documents/combined",
"certificateUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/documents/certificate",
"templatesUri": "/envelopes/99f3a387-f8e8-4763-9b50-3c2e49fc536a/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "completed",
"documentsUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/documents",
"recipientsUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/recipients",
"attachmentsUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/attachments",
"envelopeUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4",
"emailSubject": "Documents to sign",
"envelopeId": "864d7b45-e5a2-4188-a5c3-52693a2909c4",
"signingLocation": "online",
"customFieldsUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/custom_fields",
"notificationUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T09:58:49.7900000Z",
"lastModifiedDateTime": "2021-11-09T09:58:49.7900000Z",
"deliveredDateTime": "2021-11-09T09:59:06.0800000Z",
"sentDateTime": "2021-11-09T09:58:50.4330000Z",
"completedDateTime": "2021-11-09T09:59:37.2700000Z",
"statusChangedDateTime": "2021-11-09T09:59:37.2700000Z",
"documentsCombinedUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/documents/combined",
"certificateUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/documents/certificate",
"templatesUri": "/envelopes/864d7b45-e5a2-4188-a5c3-52693a2909c4/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
},
{
"status": "completed",
"documentsUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/documents",
"recipientsUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/recipients",
"attachmentsUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/attachments",
"envelopeUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce",
"emailSubject": "Documents to sign",
"envelopeId": "f01ef821-b29c-4747-804d-b379644b9bce",
"signingLocation": "online",
"customFieldsUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/custom_fields",
"notificationUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/notification",
"allowMarkup": "false",
"createdDateTime": "2021-11-09T10:14:16.2630000Z",
"lastModifiedDateTime": "2021-11-09T10:14:16.2800000Z",
"deliveredDateTime": "2021-11-09T10:14:36.8400000Z",
"sentDateTime": "2021-11-09T10:14:17.5300000Z",
"completedDateTime": "2021-11-09T10:15:11.1630000Z",
"statusChangedDateTime": "2021-11-09T10:15:11.1630000Z",
"documentsCombinedUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/documents/combined",
"certificateUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/documents/certificate",
"templatesUri": "/envelopes/f01ef821-b29c-4747-804d-b379644b9bce/templates",
"expireEnabled": "true",
"expireAfter": "120",
"sender": {
"userName": "Michele Bert",
"userId": "xxx",
"accountId": "xxx",
"email": "michele.bert@xxx.it"
},
"purgeState": "unpurged",
"envelopeIdStamping": "false",
"autoNavigation": "true",
"isSignatureProviderEnvelope": "false",
"anySigner": null,
"envelopeLocation": "not_specified"
}
]
}
对 Envelope.getEnvelopeDocuments() 的调用似乎没有在任何 REST 调用中结束。我希望它在 Envelope.documentsUri 字段中包含的 URI 请求文档列表。我错了吗？
我不清楚 env.getEnvelopeDocuments() 在做什么。
您应该使用 EnvelopeDocuments:get API 方法。
这里是 code example 从 Java 调用 API 方法。
byte[] results = envelopesApi.getDocument(accountId, envelopeId, documentId);
要将所有文档合并为一个文档，请使用保留值 "combined" 作为 documentId。
为了检索文档信息，请求 属性 include 必须包含“文档”，如 [1] 中所述。从java SDK来看，对应call
listStatusChangesOptions.setInclude("documents,...");
... 说明您需要检索的任何其他详细信息类型（例如，在我的例子中，我还需要收件人列表，因此我设置“收件人、文件").
然后，在由请求编辑的信封对象 return 上，可以调用 getEnvelopeDocuments() 方法，其中 return 一个 Document 对象的列表.此类对象包含所有摘要信息，包括“documentUri”，格式如下：
/envelopes/c34c029d-1074-4h66-afe1-324b851397c4/documents/1
它连接到基本路径，正好构成 REST API 的 URL 以下载文档。换句话说，使用此 URI 或 EnvelopesApi.getDocument() 是完全相同的事情。
结论是没有办法下载文件，如果不从每小时可用的电话中至少计算一次的话
[1] https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopes/liststatuschanges/