(PowerBuilder) 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.

For more information, see https://developers.docusign.com/esign-rest-api/guides/authentication/oauth2-code-grant

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

integer li_rc
oleobject loo_JsonToken
integer li_Success
oleobject loo_Oauth2
oleobject loo_SbJson

// 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

loo_JsonToken = create oleobject
// Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
li_rc = loo_JsonToken.ConnectToNewObject("Chilkat.JsonObject")
if li_rc < 0 then
    destroy loo_JsonToken
    MessageBox("Error","Connecting to COM object failed")
    return
end if
li_Success = loo_JsonToken.LoadFile("qa_data/tokens/docusign.json")
if li_Success <> 1 then
    Write-Debug "Failed to load docusign.json"
    destroy loo_JsonToken
    return
end if

// The access token JSON looks like this:

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

loo_Oauth2 = create oleobject
// Use "Chilkat_9_5_0.OAuth2" for versions of Chilkat < 10.0.0
li_rc = loo_Oauth2.ConnectToNewObject("Chilkat.OAuth2")

// 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
loo_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.
loo_Oauth2.ClientId = "MY_DOCUSIGN_CLIENT_ID"
// This is your secret key for the authorization code grant.
loo_Oauth2.ClientSecret = "MY_DOCUSIGN_CLIENT_SECRET"

// Get the "refresh_token"
loo_Oauth2.RefreshToken = loo_JsonToken.StringOf("refresh_token")

// Send the HTTP POST to refresh the access token..
li_Success = loo_Oauth2.RefreshAccessToken()
if li_Success <> 1 then
    Write-Debug loo_Oauth2.LastErrorText
    destroy loo_JsonToken
    destroy loo_Oauth2
    return
end if

Write-Debug "New access token: " + loo_Oauth2.AccessToken
Write-Debug "New refresh token: " + loo_Oauth2.RefreshToken

// Update the JSON with the new tokens.
loo_JsonToken.UpdateString("access_token",loo_Oauth2.AccessToken)
loo_JsonToken.UpdateString("refresh_token",loo_Oauth2.RefreshToken)

// Save the new JSON access token response to a file.
loo_SbJson = create oleobject
// Use "Chilkat_9_5_0.StringBuilder" for versions of Chilkat < 10.0.0
li_rc = loo_SbJson.ConnectToNewObject("Chilkat.StringBuilder")

loo_JsonToken.EmitCompact = 0
loo_JsonToken.EmitSb(loo_SbJson)
loo_SbJson.WriteFile("qa_data/tokens/docusign.json","utf-8",0)

Write-Debug "OAuth2 authorization granted!"
Write-Debug "New Access Token = " + loo_Oauth2.AccessToken


destroy loo_JsonToken
destroy loo_Oauth2
destroy loo_SbJson