Dart

Docusign Refresh OAuth2 Access Token

See more DocuSign Examples

Demonstrates how to refresh a Docusign OAuth2 access token. The refresh does not require user interaction via a web browser. If an access token expires (typically with a 401 response code), a new access token can be automatically obtained by using the code in this example. Dart

import 'package:chilkat/chilkat.dart';

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

  // It is assumed we previously obtained an OAuth2 access token.
  // This example loads the JSON access token file 
  // saved by this example: Get Docusign OAuth2 Access Token

  final jsonToken = CkJsonObject();
  try {
    jsonToken.loadFile('qa_data/tokens/docusign.json');
  } on ChilkatException {
    print('Failed to load docusign.json');
    return;
  }

  // The access token JSON looks like this:

  // {
  //   "access_token": "eyJ0eXA....YQyig",
  //   "token_type": "Bearer",
  //   "refresh_token": "eyJ0eXA....auE3eHKg",
  //   "expires_in": 28800
  // }

  final oauth2 = CkOAuth2();

  // For the developer sandbox environment, the token endpoint is https://account-d.docusign.com/oauth/token
  // For the production platform, the token endpoint is https://account.docusign.com/oauth/token
  oauth2.tokenEndpoint = 'https://account-d.docusign.com/oauth/token';

  // Replace these with actual values.
  // The client ID is also known as the "integration key" in Docusign.
  oauth2.clientId = 'MY_DOCUSIGN_CLIENT_ID';
  // This is your secret key for the authorization code grant.
  oauth2.clientSecret = 'MY_DOCUSIGN_CLIENT_SECRET';

  // Get the "refresh_token"
  oauth2.refreshToken = jsonToken.stringOf('refresh_token');

  // Send the HTTP POST to refresh the access token..
  try {
    oauth2.refreshAccessToken();
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  print('New access token: ${oauth2.accessToken}');
  print('New refresh token: ${oauth2.refreshToken}');

  // Update the JSON with the new tokens.
  jsonToken.updateString('access_token', oauth2.accessToken);
  jsonToken.updateString('refresh_token', oauth2.refreshToken);

  // Save the new JSON access token response to a file.
  final sbJson = CkStringBuilder();
  jsonToken.emitCompact = false;
  jsonToken.emitSb(sbJson);
  sbJson.writeFile('qa_data/tokens/docusign.json', 'utf-8', false);

  print('OAuth2 authorization granted!');
  print('New Access Token = ${oauth2.accessToken}');
}