C
C
DocuSign Add Documents to a Draft Envelope
See more DocuSign Examples
Demonstrates how to add one or more additional documents to a DocuSign draft envelope.Chilkat C Downloads
#include <C_CkHttp.h>
#include <C_CkJsonObject.h>
#include <C_CkBinData.h>
#include <C_CkStringBuilder.h>
#include <C_CkHttpResponse.h>
void ChilkatSample(void)
{
BOOL success;
HCkHttp http;
HCkJsonObject jsonToken;
HCkBinData bd1;
HCkBinData bd2;
HCkJsonObject json;
int i;
HCkStringBuilder sbJson;
const char *url;
HCkHttpResponse resp;
HCkJsonObject jResp;
int respStatusCode;
const char *documentId;
const char *documentIdGuid;
const char *name;
const char *v_type;
const char *uri;
const char *order;
const char *containsPdfFormFields;
const char *templateRequired;
const char *authoritativeCopy;
const char *envelopeId;
int count_i;
success = FALSE;
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
http = CkHttp_Create();
// Load a previously obtained OAuth2 access token.
jsonToken = CkJsonObject_Create();
success = CkJsonObject_LoadFile(jsonToken,"qa_data/tokens/docusign.json");
if (success == FALSE) {
printf("%s\n",CkJsonObject_lastErrorText(jsonToken));
CkHttp_Dispose(http);
CkJsonObject_Dispose(jsonToken);
return;
}
// Adds the "Authorization: Bearer eyJ0eXAi.....UE8Kl_V8KroQ" header.
CkHttp_putAuthToken(http,CkJsonObject_stringOf(jsonToken,"access_token"));
// Send the following request.
// Make sure to use your own account ID (obtained from Get Docusign User Account Information)
// PUT https://demo.docusign.net/restapi/v2.1/accounts/<account ID>/envelopes/<envelope ID>/documents HTTP/1.1
// Expect: 100-continue
// Accept: application/json
// Cache-Control: no-cache
// Authorization: Bearer eyJ0eX...
// Content-Length: ...
// Content-Type: application/json
//
// {
// "documents": [
// {
// "documentId": "1",
// "name": "hello.pdf",
// "pages": "1",
// "documentBase64": "<insert base64 content here>"
// },
// {
// "documentId": "2",
// "name": "hello2.pdf",
// "pages": "1",
// "documentBase64": "<insert base64 content here>"
// }
// ]
// }
bd1 = CkBinData_Create();
success = CkBinData_LoadFile(bd1,"qa_data/pdf/hello.pdf");
bd2 = CkBinData_Create();
success = CkBinData_LoadFile(bd2,"qa_data/pdf/hello2.pdf");
json = CkJsonObject_Create();
i = 0;
CkJsonObject_putI(json,i);
CkJsonObject_UpdateString(json,"documents[i].documentId","1");
CkJsonObject_UpdateString(json,"documents[i].name","hello.pdf");
CkJsonObject_UpdateString(json,"documents[i].pages","1");
CkJsonObject_UpdateString(json,"documents[i].documentBase64",CkBinData_getEncoded(bd1,"base64"));
i = i + 1;
CkJsonObject_putI(json,i);
CkJsonObject_UpdateString(json,"documents[i].documentId","2");
CkJsonObject_UpdateString(json,"documents[i].name","hello2.pdf");
CkJsonObject_UpdateString(json,"documents[i].pages","1");
CkJsonObject_UpdateString(json,"documents[i].documentBase64",CkBinData_getEncoded(bd2,"base64"));
sbJson = CkStringBuilder_Create();
CkJsonObject_putEmitCompact(json,FALSE);
CkJsonObject_EmitSb(json,sbJson);
CkHttp_SetRequestHeader(http,"Expect","100-continue");
CkHttp_SetRequestHeader(http,"Cache-Control","no-cache");
CkHttp_SetRequestHeader(http,"Accept","application/json");
// Use your own account ID here.
CkHttp_SetUrlVar(http,"accountId","7f3f65ed-5e87-418d-94c1-92499ddc8252");
// Use the envelope ID returned by DocuSign when creating the draft envelope).
CkHttp_SetUrlVar(http,"envelopeId","e01f2043-3850-4fcb-afd1-b1726216e099");
url = "https://demo.docusign.net/restapi/v2.1/accounts/{$accountId}/envelopes/{$envelopeId}/documents";
resp = CkHttpResponse_Create();
success = CkHttp_HttpSb(http,"PUT",url,sbJson,"utf-8","application/json",resp);
if (success == FALSE) {
printf("%s\n",CkHttp_lastErrorText(http));
CkHttp_Dispose(http);
CkJsonObject_Dispose(jsonToken);
CkBinData_Dispose(bd1);
CkBinData_Dispose(bd2);
CkJsonObject_Dispose(json);
CkStringBuilder_Dispose(sbJson);
CkHttpResponse_Dispose(resp);
return;
}
jResp = CkJsonObject_Create();
CkJsonObject_Load(jResp,CkHttpResponse_bodyStr(resp));
CkJsonObject_putEmitCompact(jResp,FALSE);
printf("Response Body:\n");
printf("%s\n",CkJsonObject_emit(jResp));
// If you get a 401 response status code, it's likely you need to refresh the DocuSign OAuth2 token).
respStatusCode = CkHttpResponse_getStatusCode(resp);
printf("Response Status Code = %d\n",respStatusCode);
if (respStatusCode >= 400) {
printf("Response Header:\n");
printf("%s\n",CkHttpResponse_header(resp));
printf("Failed.\n");
CkHttp_Dispose(http);
CkJsonObject_Dispose(jsonToken);
CkBinData_Dispose(bd1);
CkBinData_Dispose(bd2);
CkJsonObject_Dispose(json);
CkStringBuilder_Dispose(sbJson);
CkHttpResponse_Dispose(resp);
CkJsonObject_Dispose(jResp);
return;
}
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "envelopeId": "da9fb811-e6a4-48c0-a9fb-81ed18b989af",
// "envelopeDocuments": [
// {
// "documentId": "1",
// "documentIdGuid": "38e919fc-0a77-4b0c-9da0-e3530f4e6fc7",
// "name": "hello.pdf",
// "type": "content",
// "uri": "/envelopes/da9fb811-e6a4-48c0-a9fb-81ed18b989af/documents/1",
// "order": "3",
// "containsPdfFormFields": "false",
// "templateRequired": "false",
// "authoritativeCopy": "false"
// },
// {
// "documentId": "2",
// "documentIdGuid": "2cbd0fcc-c1ca-4a3a-b8b5-fe252dd89731",
// "name": "hello2.pdf",
// "type": "content",
// "uri": "/envelopes/da9fb811-e6a4-48c0-a9fb-81ed18b989af/documents/2",
// "order": "4",
// "containsPdfFormFields": "false",
// "templateRequired": "false",
// "authoritativeCopy": "false"
// }
// ]
// }
// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON
envelopeId = CkJsonObject_stringOf(jResp,"envelopeId");
i = 0;
count_i = CkJsonObject_SizeOfArray(jResp,"envelopeDocuments");
while (i < count_i) {
CkJsonObject_putI(jResp,i);
documentId = CkJsonObject_stringOf(jResp,"envelopeDocuments[i].documentId");
documentIdGuid = CkJsonObject_stringOf(jResp,"envelopeDocuments[i].documentIdGuid");
name = CkJsonObject_stringOf(jResp,"envelopeDocuments[i].name");
v_type = CkJsonObject_stringOf(jResp,"envelopeDocuments[i].type");
uri = CkJsonObject_stringOf(jResp,"envelopeDocuments[i].uri");
order = CkJsonObject_stringOf(jResp,"envelopeDocuments[i].order");
containsPdfFormFields = CkJsonObject_stringOf(jResp,"envelopeDocuments[i].containsPdfFormFields");
templateRequired = CkJsonObject_stringOf(jResp,"envelopeDocuments[i].templateRequired");
authoritativeCopy = CkJsonObject_stringOf(jResp,"envelopeDocuments[i].authoritativeCopy");
i = i + 1;
}
CkHttp_Dispose(http);
CkJsonObject_Dispose(jsonToken);
CkBinData_Dispose(bd1);
CkBinData_Dispose(bd2);
CkJsonObject_Dispose(json);
CkStringBuilder_Dispose(sbJson);
CkHttpResponse_Dispose(resp);
CkJsonObject_Dispose(jResp);
}