com.squareup.square.api

Class DefaultWebhookSubscriptionsApi

java.lang.Object

com.squareup.square.api.BaseApi

com.squareup.square.api.DefaultWebhookSubscriptionsApi

All Implemented Interfaces:

WebhookSubscriptionsApi

public final class DefaultWebhookSubscriptionsApi
extends BaseApi
implements WebhookSubscriptionsApi

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
DefaultWebhookSubscriptionsApi(io.apimatic.core.GlobalConfiguration globalConfig) Initializes the controller.

Method Summary

Modifier and Type	Method and Description
CreateWebhookSubscriptionResponse	createWebhookSubscription(CreateWebhookSubscriptionRequest body) Creates a webhook subscription.
CompletableFuture<CreateWebhookSubscriptionResponse>	createWebhookSubscriptionAsync(CreateWebhookSubscriptionRequest body) Creates a webhook subscription.
DeleteWebhookSubscriptionResponse	deleteWebhookSubscription(String subscriptionId) Deletes a webhook subscription.
CompletableFuture<DeleteWebhookSubscriptionResponse>	deleteWebhookSubscriptionAsync(String subscriptionId) Deletes a webhook subscription.
ListWebhookEventTypesResponse	listWebhookEventTypes(String apiVersion) Lists all webhook event types that can be subscribed to.
CompletableFuture<ListWebhookEventTypesResponse>	listWebhookEventTypesAsync(String apiVersion) Lists all webhook event types that can be subscribed to.
ListWebhookSubscriptionsResponse	listWebhookSubscriptions(String cursor, Boolean includeDisabled, String sortOrder, Integer limit) Lists all webhook subscriptions owned by your application.
CompletableFuture<ListWebhookSubscriptionsResponse>	listWebhookSubscriptionsAsync(String cursor, Boolean includeDisabled, String sortOrder, Integer limit) Lists all webhook subscriptions owned by your application.
RetrieveWebhookSubscriptionResponse	retrieveWebhookSubscription(String subscriptionId) Retrieves a webhook subscription identified by its ID.
CompletableFuture<RetrieveWebhookSubscriptionResponse>	retrieveWebhookSubscriptionAsync(String subscriptionId) Retrieves a webhook subscription identified by its ID.
TestWebhookSubscriptionResponse	testWebhookSubscription(String subscriptionId, TestWebhookSubscriptionRequest body) Tests a webhook subscription by sending a test event to the notification URL.
CompletableFuture<TestWebhookSubscriptionResponse>	testWebhookSubscriptionAsync(String subscriptionId, TestWebhookSubscriptionRequest body) Tests a webhook subscription by sending a test event to the notification URL.
UpdateWebhookSubscriptionResponse	updateWebhookSubscription(String subscriptionId, UpdateWebhookSubscriptionRequest body) Updates a webhook subscription.
CompletableFuture<UpdateWebhookSubscriptionResponse>	updateWebhookSubscriptionAsync(String subscriptionId, UpdateWebhookSubscriptionRequest body) Updates a webhook subscription.
UpdateWebhookSubscriptionSignatureKeyResponse	updateWebhookSubscriptionSignatureKey(String subscriptionId, UpdateWebhookSubscriptionSignatureKeyRequest body) Updates a webhook subscription by replacing the existing signature key with a new one.
CompletableFuture<UpdateWebhookSubscriptionSignatureKeyResponse>	updateWebhookSubscriptionSignatureKeyAsync(String subscriptionId, UpdateWebhookSubscriptionSignatureKeyRequest body) Updates a webhook subscription by replacing the existing signature key with a new one.

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

DefaultWebhookSubscriptionsApi

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

Initializes the controller.

Parameters:

globalConfig - Configurations added in client.

Method Detail

listWebhookEventTypes

public ListWebhookEventTypesResponse listWebhookEventTypes(String apiVersion)
                                                    throws ApiException,
                                                           IOException

Lists all webhook event types that can be subscribed to.

Specified by:

listWebhookEventTypes in interface WebhookSubscriptionsApi

Parameters:

apiVersion - Optional parameter: The API version for which to list event types. Setting this field overrides the default version used by the application.

Returns:

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

listWebhookEventTypesAsync

public CompletableFuture<ListWebhookEventTypesResponse> listWebhookEventTypesAsync(String apiVersion)

Lists all webhook event types that can be subscribed to.

Specified by:

listWebhookEventTypesAsync in interface WebhookSubscriptionsApi

Parameters:

apiVersion - Optional parameter: The API version for which to list event types. Setting this field overrides the default version used by the application.

Returns:

Returns the ListWebhookEventTypesResponse response from the API call

listWebhookSubscriptions

public ListWebhookSubscriptionsResponse listWebhookSubscriptions(String cursor,
                                                                 Boolean includeDisabled,
                                                                 String sortOrder,
                                                                 Integer limit)
                                                          throws ApiException,
                                                                 IOException

Lists all webhook subscriptions owned by your application.

Specified by:

listWebhookSubscriptions in interface WebhookSubscriptionsApi

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. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

includeDisabled - Optional parameter: Includes disabled [Subscription](entity:WebhookSubscription)s. By default, all enabled [Subscription](entity:WebhookSubscription)s are returned.

sortOrder - Optional parameter: Sorts the returned list by when the [Subscription](entity:WebhookSubscription) was created with the specified order. This field defaults to ASC.

limit - Optional parameter: The maximum number of results to be returned in a single page. It is possible to receive fewer results than the specified limit on a given page. The default value of 100 is also the maximum allowed value. Default: 100

Returns:

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

listWebhookSubscriptionsAsync

public CompletableFuture<ListWebhookSubscriptionsResponse> listWebhookSubscriptionsAsync(String cursor,
                                                                                         Boolean includeDisabled,
                                                                                         String sortOrder,
                                                                                         Integer limit)

Lists all webhook subscriptions owned by your application.

Specified by:

listWebhookSubscriptionsAsync in interface WebhookSubscriptionsApi

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. For more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).

includeDisabled - Optional parameter: Includes disabled [Subscription](entity:WebhookSubscription)s. By default, all enabled [Subscription](entity:WebhookSubscription)s are returned.

sortOrder - Optional parameter: Sorts the returned list by when the [Subscription](entity:WebhookSubscription) was created with the specified order. This field defaults to ASC.

limit - Optional parameter: The maximum number of results to be returned in a single page. It is possible to receive fewer results than the specified limit on a given page. The default value of 100 is also the maximum allowed value. Default: 100

Returns:

Returns the ListWebhookSubscriptionsResponse response from the API call

createWebhookSubscription

public CreateWebhookSubscriptionResponse createWebhookSubscription(CreateWebhookSubscriptionRequest body)
                                                            throws ApiException,
                                                                   IOException

Creates a webhook subscription.

Specified by:

createWebhookSubscription in interface WebhookSubscriptionsApi

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

createWebhookSubscriptionAsync

public CompletableFuture<CreateWebhookSubscriptionResponse> createWebhookSubscriptionAsync(CreateWebhookSubscriptionRequest body)

Creates a webhook subscription.

Specified by:

createWebhookSubscriptionAsync in interface WebhookSubscriptionsApi

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

deleteWebhookSubscription

public DeleteWebhookSubscriptionResponse deleteWebhookSubscription(String subscriptionId)
                                                            throws ApiException,
                                                                   IOException

Deletes a webhook subscription.

Specified by:

deleteWebhookSubscription in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to delete.

Returns:

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

deleteWebhookSubscriptionAsync

public CompletableFuture<DeleteWebhookSubscriptionResponse> deleteWebhookSubscriptionAsync(String subscriptionId)

Deletes a webhook subscription.

Specified by:

deleteWebhookSubscriptionAsync in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to delete.

Returns:

Returns the DeleteWebhookSubscriptionResponse response from the API call

retrieveWebhookSubscription

public RetrieveWebhookSubscriptionResponse retrieveWebhookSubscription(String subscriptionId)
                                                                throws ApiException,
                                                                       IOException

Retrieves a webhook subscription identified by its ID.

Specified by:

retrieveWebhookSubscription in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to retrieve.

Returns:

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

retrieveWebhookSubscriptionAsync

public CompletableFuture<RetrieveWebhookSubscriptionResponse> retrieveWebhookSubscriptionAsync(String subscriptionId)

Retrieves a webhook subscription identified by its ID.

Specified by:

retrieveWebhookSubscriptionAsync in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to retrieve.

Returns:

Returns the RetrieveWebhookSubscriptionResponse response from the API call

updateWebhookSubscription

public UpdateWebhookSubscriptionResponse updateWebhookSubscription(String subscriptionId,
                                                                   UpdateWebhookSubscriptionRequest body)
                                                            throws ApiException,
                                                                   IOException

Updates a webhook subscription.

Specified by:

updateWebhookSubscription in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to update.

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

Returns:

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

updateWebhookSubscriptionAsync

public CompletableFuture<UpdateWebhookSubscriptionResponse> updateWebhookSubscriptionAsync(String subscriptionId,
                                                                                           UpdateWebhookSubscriptionRequest body)

Updates a webhook subscription.

Specified by:

updateWebhookSubscriptionAsync in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to update.

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

Returns:

Returns the UpdateWebhookSubscriptionResponse response from the API call

updateWebhookSubscriptionSignatureKey

public UpdateWebhookSubscriptionSignatureKeyResponse updateWebhookSubscriptionSignatureKey(String subscriptionId,
                                                                                           UpdateWebhookSubscriptionSignatureKeyRequest body)
                                                                                    throws ApiException,
                                                                                           IOException

Updates a webhook subscription by replacing the existing signature key with a new one.

Specified by:

updateWebhookSubscriptionSignatureKey in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to update.

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

Returns:

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

updateWebhookSubscriptionSignatureKeyAsync

public CompletableFuture<UpdateWebhookSubscriptionSignatureKeyResponse> updateWebhookSubscriptionSignatureKeyAsync(String subscriptionId,
                                                                                                                   UpdateWebhookSubscriptionSignatureKeyRequest body)

Updates a webhook subscription by replacing the existing signature key with a new one.

Specified by:

updateWebhookSubscriptionSignatureKeyAsync in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to update.

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

Returns:

Returns the UpdateWebhookSubscriptionSignatureKeyResponse response from the API call

testWebhookSubscription

public TestWebhookSubscriptionResponse testWebhookSubscription(String subscriptionId,
                                                               TestWebhookSubscriptionRequest body)
                                                        throws ApiException,
                                                               IOException

Tests a webhook subscription by sending a test event to the notification URL.

Specified by:

testWebhookSubscription in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to test.

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

Returns:

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

testWebhookSubscriptionAsync

public CompletableFuture<TestWebhookSubscriptionResponse> testWebhookSubscriptionAsync(String subscriptionId,
                                                                                       TestWebhookSubscriptionRequest body)

Tests a webhook subscription by sending a test event to the notification URL.

Specified by:

testWebhookSubscriptionAsync in interface WebhookSubscriptionsApi

Parameters:

subscriptionId - Required parameter: [REQUIRED] The ID of the [Subscription](entity:WebhookSubscription) to test.

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

Returns:

Returns the TestWebhookSubscriptionResponse response from the API call