Skip to content

Latest commit

 

History

History
126 lines (85 loc) · 3.57 KB

OAuthApi.md

File metadata and controls

126 lines (85 loc) · 3.57 KB

Dropbox\Sign\OAuthApi

All URIs are relative to https://api.hellosign.com/v3.

Method HTTP request Description
oauthTokenGenerate() POST /oauth/token OAuth Token Generate
oauthTokenRefresh() POST /oauth/token?refresh OAuth Token Refresh

oauthTokenGenerate()

oauthTokenGenerate($o_auth_token_generate_request): \Dropbox\Sign\Model\OAuthTokenResponse

OAuth Token Generate

Once you have retrieved the code from the user callback, you will need to exchange it for an access token via a backend call.

Example

<?php

require_once __DIR__ . "/vendor/autoload.php";

$oauthApi = new Dropbox\Sign\Api\OAuthApi(
    Dropbox\Sign\Configuration::getDefaultConfiguration()
);

$data = new Dropbox\Sign\Model\OAuthTokenGenerateRequest();
$data->setState("900e06e2")
    ->setCode("1b0d28d90c86c141")
    ->setClientId("cc91c61d00f8bb2ece1428035716b")
    ->setClientSecret("1d14434088507ffa390e6f5528465");

try {
    $result = $oauthApi->oauthTokenGenerate($data);
    print_r($result);
} catch (Dropbox\Sign\ApiException $e) {
    $error = $e->getResponseObject();
    echo "Exception when calling Dropbox Sign API: "
        . print_r($error->getError());
}

Parameters

Name Type Description Notes
o_auth_token_generate_request \Dropbox\Sign\Model\OAuthTokenGenerateRequest

Return type

\Dropbox\Sign\Model\OAuthTokenResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

oauthTokenRefresh()

oauthTokenRefresh($o_auth_token_refresh_request): \Dropbox\Sign\Model\OAuthTokenResponse

OAuth Token Refresh

Access tokens are only valid for a given period of time (typically one hour) for security reasons. Whenever acquiring an new access token its TTL is also given (see expires_in), along with a refresh token that can be used to acquire a new access token after the current one has expired.

Example

<?php

require_once __DIR__ . "/vendor/autoload.php";

$oauthApi = new Dropbox\Sign\Api\OAuthApi(
    Dropbox\Sign\Configuration::getDefaultConfiguration()
);

$data = new Dropbox\Sign\Model\OAuthTokenRefreshRequest();
$data->setRefreshToken("hNTI2MTFmM2VmZDQxZTZjOWRmZmFjZmVmMGMyNGFjMzI2MGI5YzgzNmE3");

try {
    $result = $oauthApi->oauthTokenRefresh($data);
    print_r($result);
} catch (Dropbox\Sign\ApiException $e) {
    $error = $e->getResponseObject();
    echo "Exception when calling Dropbox Sign API: "
        . print_r($error->getError());
}

Parameters

Name Type Description Notes
o_auth_token_refresh_request \Dropbox\Sign\Model\OAuthTokenRefreshRequest

Return type

\Dropbox\Sign\Model\OAuthTokenResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]