com.squareup.square.api

Class DefaultOAuthApi

java.lang.Object

com.squareup.square.api.BaseApi

com.squareup.square.api.DefaultOAuthApi

All Implemented Interfaces:

OAuthApi

public final class DefaultOAuthApi
extends BaseApi
implements OAuthApi

This class lists all the endpoints of the groups.

Field Summary

Fields inherited from class com.squareup.square.api.BaseApi

AUTHENTICATION_KEY, GLOBAL_ERROR_CASES

Constructor Summary

Constructors

Constructor and Description
DefaultOAuthApi(io.apimatic.core.GlobalConfiguration globalConfig) Initializes the controller.

Method Summary

Modifier and Type	Method and Description
ObtainTokenResponse	obtainToken(ObtainTokenRequest body) Returns an OAuth access token and a refresh token unless the `short_lived` parameter is set to `true`, in which case the endpoint returns only an access token.
CompletableFuture<ObtainTokenResponse>	obtainTokenAsync(ObtainTokenRequest body) Returns an OAuth access token and a refresh token unless the `short_lived` parameter is set to `true`, in which case the endpoint returns only an access token.
RenewTokenResponse	renewToken(String clientId, RenewTokenRequest body, String authorization) Deprecated.
CompletableFuture<RenewTokenResponse>	renewTokenAsync(String clientId, RenewTokenRequest body, String authorization) Deprecated.
RetrieveTokenStatusResponse	retrieveTokenStatus(String authorization) Returns information about an [OAuth access token](https://developer.squareup.com/docs/build-basics/access-tokens#get-an-oauth-access-token) or an application’s [personal access token](https://developer.squareup.com/docs/build-basics/access-tokens#get-a-personal-access-token).
CompletableFuture<RetrieveTokenStatusResponse>	retrieveTokenStatusAsync(String authorization) Returns information about an [OAuth access token](https://developer.squareup.com/docs/build-basics/access-tokens#get-an-oauth-access-token) or an application’s [personal access token](https://developer.squareup.com/docs/build-basics/access-tokens#get-a-personal-access-token).
RevokeTokenResponse	revokeToken(RevokeTokenRequest body, String authorization) Revokes an access token generated with the OAuth flow.
CompletableFuture<RevokeTokenResponse>	revokeTokenAsync(RevokeTokenRequest body, String authorization) Revokes an access token generated with the OAuth flow.

Methods inherited from class com.squareup.square.api.BaseApi

getClientInstance, getGlobalConfiguration, getHttpCallback

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultOAuthApi

public DefaultOAuthApi(io.apimatic.core.GlobalConfiguration globalConfig)

Initializes the controller.

Parameters:

globalConfig - Configurations added in client.

Method Detail

renewToken

@Deprecated
public RenewTokenResponse renewToken(String clientId,
                                                 RenewTokenRequest body,
                                                 String authorization)
                                          throws ApiException,
                                                 IOException

Deprecated.

`RenewToken` is deprecated. For information about refreshing OAuth access tokens, see [Migrate from Renew to Refresh OAuth Tokens](https://developer.squareup.com/docs/oauth-api/migrate-to-refresh-tokens). Renews an OAuth access token before it expires. OAuth access tokens besides your application's personal access token expire after 30 days. You can also renew expired tokens within 15 days of their expiration. You cannot renew an access token that has been expired for more than 15 days. Instead, the associated user must recomplete the OAuth flow from the beginning. __Important:__ The `Authorization` header for this endpoint must have the following format: ``` Authorization: Client APPLICATION_SECRET ``` Replace `APPLICATION_SECRET` with the application secret on the **Credentials** page in the [Developer Dashboard](https://developer.squareup.com/apps).

Specified by:

renewToken in interface OAuthApi

Parameters:

clientId - Required parameter: Your application ID, which is available on the **OAuth** page in the [Developer Dashboard](https://developer.squareup.com/apps).

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

authorization - Required parameter: Client APPLICATION_SECRET

Returns:

Returns the RenewTokenResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

renewTokenAsync

@Deprecated
public CompletableFuture<RenewTokenResponse> renewTokenAsync(String clientId,
                                                                         RenewTokenRequest body,
                                                                         String authorization)

Deprecated.

`RenewToken` is deprecated. For information about refreshing OAuth access tokens, see [Migrate from Renew to Refresh OAuth Tokens](https://developer.squareup.com/docs/oauth-api/migrate-to-refresh-tokens). Renews an OAuth access token before it expires. OAuth access tokens besides your application's personal access token expire after 30 days. You can also renew expired tokens within 15 days of their expiration. You cannot renew an access token that has been expired for more than 15 days. Instead, the associated user must recomplete the OAuth flow from the beginning. __Important:__ The `Authorization` header for this endpoint must have the following format: ``` Authorization: Client APPLICATION_SECRET ``` Replace `APPLICATION_SECRET` with the application secret on the **Credentials** page in the [Developer Dashboard](https://developer.squareup.com/apps).

Specified by:

renewTokenAsync in interface OAuthApi

Parameters:

clientId - Required parameter: Your application ID, which is available on the **OAuth** page in the [Developer Dashboard](https://developer.squareup.com/apps).

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

authorization - Required parameter: Client APPLICATION_SECRET

Returns:

Returns the RenewTokenResponse response from the API call

revokeToken

public RevokeTokenResponse revokeToken(RevokeTokenRequest body,
                                       String authorization)
                                throws ApiException,
                                       IOException

Revokes an access token generated with the OAuth flow. If an account has more than one OAuth access token for your application, this endpoint revokes all of them, regardless of which token you specify. When an OAuth access token is revoked, all of the active subscriptions associated with that OAuth token are canceled immediately. __Important:__ The `Authorization` header for this endpoint must have the following format: ``` Authorization: Client APPLICATION_SECRET ``` Replace `APPLICATION_SECRET` with the application secret on the **OAuth** page for your application in the Developer Dashboard.

Specified by:

revokeToken in interface OAuthApi

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

authorization - Required parameter: Client APPLICATION_SECRET

Returns:

Returns the RevokeTokenResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

revokeTokenAsync

public CompletableFuture<RevokeTokenResponse> revokeTokenAsync(RevokeTokenRequest body,
                                                               String authorization)

Revokes an access token generated with the OAuth flow. If an account has more than one OAuth access token for your application, this endpoint revokes all of them, regardless of which token you specify. When an OAuth access token is revoked, all of the active subscriptions associated with that OAuth token are canceled immediately. __Important:__ The `Authorization` header for this endpoint must have the following format: ``` Authorization: Client APPLICATION_SECRET ``` Replace `APPLICATION_SECRET` with the application secret on the **OAuth** page for your application in the Developer Dashboard.

Specified by:

revokeTokenAsync in interface OAuthApi

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

authorization - Required parameter: Client APPLICATION_SECRET

Returns:

Returns the RevokeTokenResponse response from the API call

obtainToken

public ObtainTokenResponse obtainToken(ObtainTokenRequest body)
                                throws ApiException,
                                       IOException

Returns an OAuth access token and a refresh token unless the `short_lived` parameter is set to `true`, in which case the endpoint returns only an access token. The `grant_type` parameter specifies the type of OAuth request. If `grant_type` is `authorization_code`, you must include the authorization code you received when a seller granted you authorization. If `grant_type` is `refresh_token`, you must provide a valid refresh token. If you're using an old version of the Square APIs (prior to March 13, 2019), `grant_type` can be `migration_token` and you must provide a valid migration token. You can use the `scopes` parameter to limit the set of permissions granted to the access token and refresh token. You can use the `short_lived` parameter to create an access token that expires in 24 hours. __Note:__ OAuth tokens should be encrypted and stored on a secure server. Application clients should never interact directly with OAuth tokens.

Specified by:

obtainToken in interface OAuthApi

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the ObtainTokenResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

obtainTokenAsync

public CompletableFuture<ObtainTokenResponse> obtainTokenAsync(ObtainTokenRequest body)

Returns an OAuth access token and a refresh token unless the `short_lived` parameter is set to `true`, in which case the endpoint returns only an access token. The `grant_type` parameter specifies the type of OAuth request. If `grant_type` is `authorization_code`, you must include the authorization code you received when a seller granted you authorization. If `grant_type` is `refresh_token`, you must provide a valid refresh token. If you're using an old version of the Square APIs (prior to March 13, 2019), `grant_type` can be `migration_token` and you must provide a valid migration token. You can use the `scopes` parameter to limit the set of permissions granted to the access token and refresh token. You can use the `short_lived` parameter to create an access token that expires in 24 hours. __Note:__ OAuth tokens should be encrypted and stored on a secure server. Application clients should never interact directly with OAuth tokens.

Specified by:

obtainTokenAsync in interface OAuthApi

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the ObtainTokenResponse response from the API call

retrieveTokenStatus

public RetrieveTokenStatusResponse retrieveTokenStatus(String authorization)
                                                throws ApiException,
                                                       IOException

Returns information about an [OAuth access token](https://developer.squareup.com/docs/build-basics/access-tokens#get-an-oauth-access-token) or an application’s [personal access token](https://developer.squareup.com/docs/build-basics/access-tokens#get-a-personal-access-token). Add the access token to the Authorization header of the request. __Important:__ The `Authorization` header you provide to this endpoint must have the following format: ``` Authorization: Bearer ACCESS_TOKEN ``` where `ACCESS_TOKEN` is a [valid production authorization credential](https://developer.squareup.com/docs/build-basics/access-tokens). If the access token is expired or not a valid access token, the endpoint returns an `UNAUTHORIZED` error.

Specified by:

retrieveTokenStatus in interface OAuthApi

Parameters:

authorization - Required parameter: Client APPLICATION_SECRET

Returns:

Returns the RetrieveTokenStatusResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

retrieveTokenStatusAsync

public CompletableFuture<RetrieveTokenStatusResponse> retrieveTokenStatusAsync(String authorization)

Returns information about an [OAuth access token](https://developer.squareup.com/docs/build-basics/access-tokens#get-an-oauth-access-token) or an application’s [personal access token](https://developer.squareup.com/docs/build-basics/access-tokens#get-a-personal-access-token). Add the access token to the Authorization header of the request. __Important:__ The `Authorization` header you provide to this endpoint must have the following format: ``` Authorization: Bearer ACCESS_TOKEN ``` where `ACCESS_TOKEN` is a [valid production authorization credential](https://developer.squareup.com/docs/build-basics/access-tokens). If the access token is expired or not a valid access token, the endpoint returns an `UNAUTHORIZED` error.

Specified by:

retrieveTokenStatusAsync in interface OAuthApi

Parameters:

authorization - Required parameter: Client APPLICATION_SECRET

Returns:

Returns the RetrieveTokenStatusResponse response from the API call