Lua

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. Lua

local chilkat = require("chilkat")

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

local jsonToken = chilkat.JsonObject.new()
local success = jsonToken:load_file("qa_data/tokens/docusign.json")
if not success then
    print("Failed to load docusign.json")
    return
end

-- The access token JSON looks like this:

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

local oauth2 = chilkat.OAuth2.new()

-- 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.token_endpoint = "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.client_id = "MY_DOCUSIGN_CLIENT_ID"
-- This is your secret key for the authorization code grant.
oauth2.client_secret = "MY_DOCUSIGN_CLIENT_SECRET"

-- Get the "refresh_token"
oauth2.refresh_token = jsonToken:string_of("refresh_token")

-- Send the HTTP POST to refresh the access token..
success = oauth2:refresh_access_token()
if not success then
    print(oauth2.last_error_text)
    return
end

print("New access token: " .. oauth2.access_token)
print("New refresh token: " .. oauth2.refresh_token)

-- Update the JSON with the new tokens.
jsonToken:update_string("access_token", oauth2.access_token)
jsonToken:update_string("refresh_token", oauth2.refresh_token)

-- Save the new JSON access token response to a file.
local sbJson = chilkat.StringBuilder.new()
jsonToken.emit_compact = false
jsonToken:emit_sb(sbJson)
sbJson:write_file("qa_data/tokens/docusign.json", "utf-8", false)

print("OAuth2 authorization granted!")
print("New Access Token = " .. oauth2.access_token)