com.squareup.square.api

Class DefaultDevicesApi

java.lang.Object

com.squareup.square.api.BaseApi

com.squareup.square.api.DefaultDevicesApi

All Implemented Interfaces:

DevicesApi

public final class DefaultDevicesApi
extends BaseApi
implements DevicesApi

This class lists all the endpoints of the groups.

Nested Class Summary

Nested classes/interfaces inherited from class com.squareup.square.api.BaseApi

BaseApi.RequestExecutor, BaseApi.RequestSupplier, BaseApi.ResponseHandler<T>

Field Summary

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

authManagers, config, httpCallback, internalUserAgent

Constructor Summary

Constructors

Constructor and Description
DefaultDevicesApi(Configuration config, HttpClient httpClient, Map<String,AuthManager> authManagers) Initializes the controller.
DefaultDevicesApi(Configuration config, HttpClient httpClient, Map<String,AuthManager> authManagers, HttpCallback httpCallback) Initializes the controller with HTTPCallback.

Method Summary

Modifier and Type	Method and Description
CreateDeviceCodeResponse	createDeviceCode(CreateDeviceCodeRequest body) Creates a DeviceCode that can be used to login to a Square Terminal device to enter the connected terminal mode.
CompletableFuture<CreateDeviceCodeResponse>	createDeviceCodeAsync(CreateDeviceCodeRequest body) Creates a DeviceCode that can be used to login to a Square Terminal device to enter the connected terminal mode.
GetDeviceCodeResponse	getDeviceCode(String id) Retrieves DeviceCode with the associated ID.
CompletableFuture<GetDeviceCodeResponse>	getDeviceCodeAsync(String id) Retrieves DeviceCode with the associated ID.
ListDeviceCodesResponse	listDeviceCodes(String cursor, String locationId, String productType, String status) Lists all DeviceCodes associated with the merchant.
CompletableFuture<ListDeviceCodesResponse>	listDeviceCodesAsync(String cursor, String locationId, String productType, String status) Lists all DeviceCodes associated with the merchant.

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

getClientInstance, getHttpCallback, makeHttpCallAsync, validateResponse

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultDevicesApi

public DefaultDevicesApi(Configuration config,
                         HttpClient httpClient,
                         Map<String,AuthManager> authManagers)

Initializes the controller.

Parameters:

config - Configurations added in client.

httpClient - Send HTTP requests and read the responses.

authManagers - Apply authorization to requests.

DefaultDevicesApi

public DefaultDevicesApi(Configuration config,
                         HttpClient httpClient,
                         Map<String,AuthManager> authManagers,
                         HttpCallback httpCallback)

Initializes the controller with HTTPCallback.

Parameters:

config - Configurations added in client.

httpClient - Send HTTP requests and read the responses.

authManagers - Apply authorization to requests.

httpCallback - Callback to be called before and after the HTTP call.

Method Detail

listDeviceCodes

public ListDeviceCodesResponse listDeviceCodes(String cursor,
                                               String locationId,
                                               String productType,
                                               String status)
                                        throws ApiException,
                                               IOException

Lists all DeviceCodes associated with the merchant.

Specified by:

listDeviceCodes in interface DevicesApi

Parameters:

cursor - Optional parameter: A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for your original query. See [Paginating results](https://developer.squareup.com/docs/working-with-apis/pagination) for more information.

locationId - Optional parameter: If specified, only returns DeviceCodes of the specified location. Returns DeviceCodes of all locations if empty.

productType - Optional parameter: If specified, only returns DeviceCodes targeting the specified product type. Returns DeviceCodes of all product types if empty.

status - Optional parameter: If specified, returns DeviceCodes with the specified statuses. Returns DeviceCodes of status `PAIRED` and `UNPAIRED` if empty.

Returns:

Returns the ListDeviceCodesResponse 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.

listDeviceCodesAsync

public CompletableFuture<ListDeviceCodesResponse> listDeviceCodesAsync(String cursor,
                                                                       String locationId,
                                                                       String productType,
                                                                       String status)

Lists all DeviceCodes associated with the merchant.

Specified by:

listDeviceCodesAsync in interface DevicesApi

Parameters:

cursor - Optional parameter: A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for your original query. See [Paginating results](https://developer.squareup.com/docs/working-with-apis/pagination) for more information.

locationId - Optional parameter: If specified, only returns DeviceCodes of the specified location. Returns DeviceCodes of all locations if empty.

productType - Optional parameter: If specified, only returns DeviceCodes targeting the specified product type. Returns DeviceCodes of all product types if empty.

status - Optional parameter: If specified, returns DeviceCodes with the specified statuses. Returns DeviceCodes of status `PAIRED` and `UNPAIRED` if empty.

Returns:

Returns the ListDeviceCodesResponse response from the API call

createDeviceCode

public CreateDeviceCodeResponse createDeviceCode(CreateDeviceCodeRequest body)
                                          throws ApiException,
                                                 IOException

Creates a DeviceCode that can be used to login to a Square Terminal device to enter the connected terminal mode.

Specified by:

createDeviceCode in interface DevicesApi

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

createDeviceCodeAsync

public CompletableFuture<CreateDeviceCodeResponse> createDeviceCodeAsync(CreateDeviceCodeRequest body)

Creates a DeviceCode that can be used to login to a Square Terminal device to enter the connected terminal mode.

Specified by:

createDeviceCodeAsync in interface DevicesApi

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 CreateDeviceCodeResponse response from the API call

getDeviceCode

public GetDeviceCodeResponse getDeviceCode(String id)
                                    throws ApiException,
                                           IOException

Retrieves DeviceCode with the associated ID.

Specified by:

getDeviceCode in interface DevicesApi

Parameters:

id - Required parameter: The unique identifier for the device code.

Returns:

Returns the GetDeviceCodeResponse 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.

getDeviceCodeAsync

public CompletableFuture<GetDeviceCodeResponse> getDeviceCodeAsync(String id)

Retrieves DeviceCode with the associated ID.

Specified by:

getDeviceCodeAsync in interface DevicesApi

Parameters:

id - Required parameter: The unique identifier for the device code.

Returns:

Returns the GetDeviceCodeResponse response from the API call