Sample code for 30+ languages & platforms
Dart

Yousign Procedure Creation Basic Mode Upload File

See more Yousign Examples

Demonstrates the 1st step of Yousign procedure creation, which is to upload a PDF file.

Chilkat Dart Downloads

Dart
import 'package:chilkat/chilkat.dart';

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

  final http = CkHttp();

  // Implements the following CURL command:

  // curl --location --request POST 'https://staging-api.yousign.com/files' \
  // --header 'Authorization: Bearer YOUR_API_KEY' \
  // --header 'Content-Type: application/json' \
  // --data-raw '{
  //     "name": "The best name for my file.pdf",
  //     "content": "JVBERi0..." }'

  // Load a PDF file to be uploaded.
  final pdfData = CkBinData();
  try {
    pdfData.loadFile('qa_data/pdf/helloWorld.pdf');
  } on ChilkatException {
    print('Failed to load PDF local file.');
    return;
  }

  // Use the following online tool to generate HTTP code from a CURL command
  // Convert a cURL Command to HTTP Source Code

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

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

  // {
  //   "name": "The best name for my file.pdf",
  //   "content": "JVBERi0..."
  // }

  final json = CkJsonObject();
  json.updateString('name', 'helloWorld.pdf');
  json.updateString('content', pdfData.getEncoded('base64'));

  // Adds the "Authorization: Bearer YOUR_API_KEY" header.
  http.authToken = 'YOUR_API_KEY';

  final resp = CkHttpResponse();
  try {
    http.httpJson('POST', 'https://staging-api.yousign.com/files', json, 'application/json', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  final sbResponseBody = CkStringBuilder();
  resp.getBodySb(sbResponseBody);
  final jResp = CkJsonObject();
  jResp.loadSb(sbResponseBody);
  jResp.emitCompact = false;

  print('Response Body:');
  print(jResp.emit());

  final respStatusCode = resp.statusCode;
  print('Response Status Code = $respStatusCode');
  if (respStatusCode >= 400) {
    print('Response Header:');
    print(resp.header);
    print('Failed.');
    return;
  }

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

  // {
  //   "id": "/files/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  //   "name": "The best name for my file.pdf",
  //   "type": "signable",
  //   "contentType": "application/pdf",
  //   "description": null,
  //   "createdAt": "2018-12-01T11:36:20+01:00",
  //   "updatedAt": "2018-12-01T11:36:20+01:00",
  //   "sha256": "bb57ae2b2ca6ad0133a699350d1a6f6c8cdfde3cf872cf526585d306e4675cc2",
  //   "metadata": [
  //   ],
  //   "workspace": "/workspaces/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  //   "creator": null,
  //   "protected": false,
  //   "position": 0,
  //   "parent": null
  // }

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

  final id = jResp.stringOf('id');
  final name = jResp.stringOf('name');
  final vType = jResp.stringOf('type');
  final contentType = jResp.stringOf('contentType');
  final description = jResp.stringOf('description');
  final createdAt = jResp.stringOf('createdAt');
  final updatedAt = jResp.stringOf('updatedAt');
  final sha256 = jResp.stringOf('sha256');
  final workspace = jResp.stringOf('workspace');
  final creator = jResp.stringOf('creator');
  final position = jResp.intOf('position');
  final parent = jResp.stringOf('parent');
  var i = 0;
  final countI = jResp.sizeOfArray('metadata');
  while (i < countI) {
    jResp.i = i;
    i++;
  }
}