Rust

DocuSign: Requesting a Signature via Email (Remote Signing)

See more DocuSign Examples

This code example demonstrates the simplest and quickest workflow for requesting a signature for a document via email. The email will contain a signing link the recipient can use to electronically sign a document from their mobile or desktop computer. Rust

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

let http = chilkat::Http::new();

// Implements the following CURL command:

// curl --request POST https://demo.docusign.net/restapi/v2.1/accounts/${accountId}/envelopes \
//      --header "Authorization: Bearer ${accessToken}" \
//      --header "Content-Type: application/json" \
//      --data '{
//     "emailSubject": "Please sign this document",
//     "documents": [
//         {
//             "documentBase64": "JVBERi0xLjMKMyAwIG9iag ... dGFydHhyZWYKNjk5CiUlRU9GCg==",
//             "name": "Lorem Ipsum",
//             "fileExtension": "pdf",
//             "documentId": "1"
//         }
//     ],
//     "recipients": {
//         "signers": [
//             {
//                 "email": "joe_sample@example.com",
//                 "name": "Joe Sample",
//                 "recipientId": "1",
//                 "routingOrder": "1",
//                 "tabs": {
//                     "signHereTabs": [
//                         {
//                             "documentId": "1", "pageNumber": "1",
//                             "recipientId": "1", "tabLabel": "SignHereTab",
//                             "xPosition": "195", "yPosition": "147"
//                         }
//                     ]
//                 }
//             }
//         ]
//     },
//     "status": "sent"
// }'

// Use this online tool to generate code from sample JSON:
// Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "emailSubject": "Please sign this document",
//   "documents": [
//     {
//       "documentBase64": "JVBERi0xLjMKMyAwIG9iag ... dGFydHhyZWYKNjk5CiUlRU9GCg==",
//       "name": "Lorem Ipsum",
//       "fileExtension": "pdf",
//       "documentId": "1"
//     }
//   ],
//   "recipients": {
//     "signers": [
//       {
//         "email": "joe_sample@example.com",
//         "name": "Joe Sample",
//         "recipientId": "1",
//         "routingOrder": "1",
//         "tabs": {
//           "signHereTabs": [
//             {
//               "documentId": "1",
//               "pageNumber": "1",
//               "recipientId": "1",
//               "tabLabel": "SignHereTab",
//               "xPosition": "195",
//               "yPosition": "147"
//             }
//           ]
//         }
//       }
//     ]
//   },
//   "status": "sent"
// }

// Load a PDF to be signed.
let pdf_data = chilkat::BinData::new();
if pdf_data.load_file("qa_data/pdf/helloWorld.pdf").is_err() {
    println!("Failed to load local PDF file.");
    return;
}

let json = chilkat::JsonObject::new();
let _ = json.update_string("emailSubject", "Please sign this document");
let _ = json.update_string("documents[0].documentBase64", &pdf_data.get_encoded("base64").unwrap_or_default());
let _ = json.update_string("documents[0].name", "Lorem Ipsum");
let _ = json.update_string("documents[0].fileExtension", "pdf");
let _ = json.update_string("documents[0].documentId", "1");
let _ = json.update_string("recipients.signers[0].email", "joe_sample@example.com");
let _ = json.update_string("recipients.signers[0].name", "Joe Sample");
let _ = json.update_string("recipients.signers[0].recipientId", "1");
let _ = json.update_string("recipients.signers[0].routingOrder", "1");
let _ = json.update_string("recipients.signers[0].tabs.signHereTabs[0].documentId", "1");
let _ = json.update_string("recipients.signers[0].tabs.signHereTabs[0].pageNumber", "1");
let _ = json.update_string("recipients.signers[0].tabs.signHereTabs[0].recipientId", "1");
let _ = json.update_string("recipients.signers[0].tabs.signHereTabs[0].tabLabel", "SignHereTab");
let _ = json.update_string("recipients.signers[0].tabs.signHereTabs[0].xPosition", "195");
let _ = json.update_string("recipients.signers[0].tabs.signHereTabs[0].yPosition", "147");
let _ = json.update_string("status", "sent");

// Get our previously obtained OAuth2 access token, which should contain JSON like this:
// {
//   "access_token": "eyJ0eXA....YQyig",
//   "token_type": "Bearer",
//   "refresh_token": "eyJ0eXA....auE3eHKg",
//   "expires_in": 28800
// }

let json_token = chilkat::JsonObject::new();
let _ = json_token.load_file("qa_data/tokens/docusign.json").is_ok();

let sb_auth = chilkat::StringBuilder::new();
let _ = sb_auth.append("Bearer ");
let _ = sb_auth.append(&json_token.string_of("access_token").unwrap_or_default());

http.set_request_header("Authorization", &sb_auth.get_as_string().unwrap_or_default());
http.set_request_header("Content-Type", "application/json");

// Don't forget to modify this line to use your account ID
let resp = chilkat::HttpResponse::new();
if http.http_json("POST", "https://demo.docusign.net/restapi/v2.1/accounts/${accountId}/envelopes", &json, "application/json", &resp).is_err() {
    println!("{}", http.last_error_text());
    return;
}

let sb_response_body = chilkat::StringBuilder::new();
let _ = resp.get_body_sb(&sb_response_body);
let j_resp = chilkat::JsonObject::new();
let _ = j_resp.load_sb(&sb_response_body);
j_resp.set_emit_compact(false);

println!("Response Body:");
println!("{}", j_resp.emit().unwrap_or_default());

let resp_status_code = resp.status_code();
println!("Response Status Code = {}", resp_status_code);
if resp_status_code >= 400 {
    println!("Response Header:");
    println!("{}", resp.header());
    println!("Failed.");
    return;
}

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "envelopeId": "d51cfdab-22ed-4832-bf68-446c44077ffc",
//   "uri": "/envelopes/d51cfdab-22ed-4832-bf68-446c44077ffc",
//   "statusDateTime": "2018-04-17T16:31:51.8830000Z",
//   "status": "sent"
// }

// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON

let envelope_id = j_resp.string_of("envelopeId").unwrap_or_default();
let uri = j_resp.string_of("uri").unwrap_or_default();
let status_date_time = j_resp.string_of("statusDateTime").unwrap_or_default();
let status = j_resp.string_of("status").unwrap_or_default();