au.org.consumerdatastandards.client.api

Class BankingProductsAPI

java.lang.Object

au.org.consumerdatastandards.client.api.BankingProductsAPI

public class BankingProductsAPI
extends Object

Constructor Summary

Constructors

Constructor and Description
BankingProductsAPI()
BankingProductsAPI(ApiClient apiClient)

Method Summary

Modifier and Type	Method and Description
ApiClient	getApiClient()
ResponseBankingProductById	getProductDetail(String productId) Get Product Detail * Obtain detailed information on a single product offered openly to the market
okhttp3.Call	getProductDetailAsync(String productId, ApiCallback<ResponseBankingProductById> _callback) Get Product Detail (asynchronously) * Obtain detailed information on a single product offered openly to the market
okhttp3.Call	getProductDetailCall(String productId, ApiCallback<ResponseBankingProductById> _callback) Build call for getProductDetail
ApiResponse<ResponseBankingProductById>	getProductDetailWithHttpInfo(String productId) Get Product Detail * Obtain detailed information on a single product offered openly to the market
ResponseBankingProductList	listProducts(ParamEffective effective, String updatedSince, String brand, ParamProductCategory productCategory, Integer page, Integer pageSize) Get Products * Obtain a list of products that are currently openly offered to the market Note that the results returned by this end point are expected to be ordered according to updated-since ### Conventions In the product reference payloads there are a number of recurring conventions that are explained here, in one place.
okhttp3.Call	listProductsAsync(ParamEffective effective, String updatedSince, String brand, ParamProductCategory productCategory, Integer page, Integer pageSize, ApiCallback<ResponseBankingProductList> _callback) Get Products (asynchronously) * Obtain a list of products that are currently openly offered to the market Note that the results returned by this end point are expected to be ordered according to updated-since ### Conventions In the product reference payloads there are a number of recurring conventions that are explained here, in one place.
okhttp3.Call	listProductsCall(ParamEffective effective, String updatedSince, String brand, ParamProductCategory productCategory, Integer page, Integer pageSize, ApiCallback<ResponseBankingProductList> _callback) Build call for listProducts
ApiResponse<ResponseBankingProductList>	listProductsWithHttpInfo(ParamEffective effective, String updatedSince, String brand, ParamProductCategory productCategory, Integer page, Integer pageSize) Get Products * Obtain a list of products that are currently openly offered to the market Note that the results returned by this end point are expected to be ordered according to updated-since ### Conventions In the product reference payloads there are a number of recurring conventions that are explained here, in one place.
void	setApiClient(ApiClient apiClient)

Methods inherited from class java.lang.Object

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

Constructor Detail

BankingProductsAPI

public BankingProductsAPI()

BankingProductsAPI

public BankingProductsAPI(ApiClient apiClient)

Method Detail

getApiClient

public ApiClient getApiClient()

setApiClient

public void setApiClient(ApiClient apiClient)

listProductsCall

public okhttp3.Call listProductsCall(ParamEffective effective,
                                     String updatedSince,
                                     String brand,
                                     ParamProductCategory productCategory,
                                     Integer page,
                                     Integer pageSize,
                                     ApiCallback<ResponseBankingProductList> _callback)
                              throws ApiException

Build call for listProducts

Parameters:

effective - Allows for the filtering of products based on whether the current time is within the period of time defined as effective by the effectiveFrom and effectiveTo fields. Valid values are ‘CURRENT’, ‘FUTURE’ and ‘ALL’. If absent defaults to 'CURRENT'

updatedSince - Only include products that have been updated after the specified date and time. If absent defaults to include all products

brand - Filter results based on a specific brand

productCategory - Used to filter results on the productCategory field applicable to accounts. Any one of the valid values for this field can be supplied. If absent then all accounts returned.

page - Page of results to request (standard pagination)

pageSize - Page size to request. Default is 25 (standard pagination)

_callback - The callback to be executed when the API call finishes

Returns:

Call to execute

Throws:

ApiException - If fail to serialize the request body object

listProducts

public ResponseBankingProductList listProducts(ParamEffective effective,
                                               String updatedSince,
                                               String brand,
                                               ParamProductCategory productCategory,
                                               Integer page,
                                               Integer pageSize)
                                        throws ApiException

Get Products * Obtain a list of products that are currently openly offered to the market Note that the results returned by this end point are expected to be ordered according to updated-since ### Conventions In the product reference payloads there are a number of recurring conventions that are explained here, in one place. #### Arrays Of Features In the product detail payload there are a number of arrays articulating generic features, constraints, prices, etc. The intent of these arrays is as follows: - Each element in an array has the same structure so that clients can reliably interpret the payloads - Each element as a type element that is an enumeration of the specific aspect of a product being described, such as types of fees. - Each element has a field name additionalValue. This is a generic field with contents that will vary based on the type of object being described. The contents of this field for the ADDITIONAL_CARDS feature is the number of cards allowed while the contents of this field for the MAX_LIMIT constraint would be the maximum credit limit allowed for the product. - An element in these arrays of the same type may appear more than once. For instance, a product may offer two separate loyalty programs that the customer can select from. A fixed term mortgage may have different rates for different term lengths. - An element in these arrays may contain an additionalInfo and additionalInfoUri field. The additionalInfo field is used to provide displayable text clarifying the purpose of the element in some way when the product is presented to a customer. The additionalInfoUri provides a link to externally hosted information specifically relevant to that feature of the product. - Depending on the type of data being represented there may be additional specific fields. #### URIs To More Information As the complexities and nuances of a financial product can not easily be fully expressed in a data structure without a high degree of complexity it is necessary to provide additional reference information that a potential customer can access so that they are fully informed of the features and implications of the product. The payloads for product reference therefore contain numerous fields that are provided to allow the product provider to describe the product more fully using a web page hosted on their on channels. These URIs do not need to all link to different pages. If desired, they can all link to a single hosted page and use difference HTML anchors to focus on a specific topic such as eligibility or fees. #### Linkage To Accounts From the moment that a customer applies for a product and an account is created the account and the product that spawned it will diverge. Rates and features of the product may change and a discount may be negotiated for the account. For this reason, while productCategory is a common field between accounts and products, there is no specific ID that can be used to link an account to a product within the regime. Similarly, many of the fields and objects in the product payload will appear in the account detail payload but the structures and semantics are not identical as one refers to a product that can potentially be originated and one refers to an account that actual has been instantiated and created along with the associated decisions inherent in that process. #### Dates It is expected that data consumers needing this data will call relatively frequently to ensure the data they have is representative of the current offering from a bank. To minimise the volume and frequency of these calls the ability to set a lastUpdated field with the date and time of the last update to this product is included. A call for a list of products can then be filtered to only return products that have been updated since the last time that data was obtained using the updated-since query parameter. In addition, the concept of effective date and time has also been included. This allows for a product to be marked for obsolescence, or introduction, from a certain time without the need for an update to show that a product has been changed. The inclusion of these dates also removes the need to represent deleted products in the payload. Products that are no long offered can be marked not effective for a few weeks before they are then removed from the product set as an option entirely.

Parameters:

effective - Allows for the filtering of products based on whether the current time is within the period of time defined as effective by the effectiveFrom and effectiveTo fields. Valid values are ‘CURRENT’, ‘FUTURE’ and ‘ALL’. If absent defaults to 'CURRENT'

updatedSince - Only include products that have been updated after the specified date and time. If absent defaults to include all products

brand - Filter results based on a specific brand

productCategory - Used to filter results on the productCategory field applicable to accounts. Any one of the valid values for this field can be supplied. If absent then all accounts returned.

page - Page of results to request (standard pagination)

pageSize - Page size to request. Default is 25 (standard pagination)

Returns:

ResponseBankingProductList

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

listProductsWithHttpInfo

public ApiResponse<ResponseBankingProductList> listProductsWithHttpInfo(ParamEffective effective,
                                                                        String updatedSince,
                                                                        String brand,
                                                                        ParamProductCategory productCategory,
                                                                        Integer page,
                                                                        Integer pageSize)
                                                                 throws ApiException

Get Products * Obtain a list of products that are currently openly offered to the market Note that the results returned by this end point are expected to be ordered according to updated-since ### Conventions In the product reference payloads there are a number of recurring conventions that are explained here, in one place. #### Arrays Of Features In the product detail payload there are a number of arrays articulating generic features, constraints, prices, etc. The intent of these arrays is as follows: - Each element in an array has the same structure so that clients can reliably interpret the payloads - Each element as a type element that is an enumeration of the specific aspect of a product being described, such as types of fees. - Each element has a field name additionalValue. This is a generic field with contents that will vary based on the type of object being described. The contents of this field for the ADDITIONAL_CARDS feature is the number of cards allowed while the contents of this field for the MAX_LIMIT constraint would be the maximum credit limit allowed for the product. - An element in these arrays of the same type may appear more than once. For instance, a product may offer two separate loyalty programs that the customer can select from. A fixed term mortgage may have different rates for different term lengths. - An element in these arrays may contain an additionalInfo and additionalInfoUri field. The additionalInfo field is used to provide displayable text clarifying the purpose of the element in some way when the product is presented to a customer. The additionalInfoUri provides a link to externally hosted information specifically relevant to that feature of the product. - Depending on the type of data being represented there may be additional specific fields. #### URIs To More Information As the complexities and nuances of a financial product can not easily be fully expressed in a data structure without a high degree of complexity it is necessary to provide additional reference information that a potential customer can access so that they are fully informed of the features and implications of the product. The payloads for product reference therefore contain numerous fields that are provided to allow the product provider to describe the product more fully using a web page hosted on their on channels. These URIs do not need to all link to different pages. If desired, they can all link to a single hosted page and use difference HTML anchors to focus on a specific topic such as eligibility or fees. #### Linkage To Accounts From the moment that a customer applies for a product and an account is created the account and the product that spawned it will diverge. Rates and features of the product may change and a discount may be negotiated for the account. For this reason, while productCategory is a common field between accounts and products, there is no specific ID that can be used to link an account to a product within the regime. Similarly, many of the fields and objects in the product payload will appear in the account detail payload but the structures and semantics are not identical as one refers to a product that can potentially be originated and one refers to an account that actual has been instantiated and created along with the associated decisions inherent in that process. #### Dates It is expected that data consumers needing this data will call relatively frequently to ensure the data they have is representative of the current offering from a bank. To minimise the volume and frequency of these calls the ability to set a lastUpdated field with the date and time of the last update to this product is included. A call for a list of products can then be filtered to only return products that have been updated since the last time that data was obtained using the updated-since query parameter. In addition, the concept of effective date and time has also been included. This allows for a product to be marked for obsolescence, or introduction, from a certain time without the need for an update to show that a product has been changed. The inclusion of these dates also removes the need to represent deleted products in the payload. Products that are no long offered can be marked not effective for a few weeks before they are then removed from the product set as an option entirely.

Parameters:

effective - Allows for the filtering of products based on whether the current time is within the period of time defined as effective by the effectiveFrom and effectiveTo fields. Valid values are ‘CURRENT’, ‘FUTURE’ and ‘ALL’. If absent defaults to 'CURRENT'

updatedSince - Only include products that have been updated after the specified date and time. If absent defaults to include all products

brand - Filter results based on a specific brand

productCategory - Used to filter results on the productCategory field applicable to accounts. Any one of the valid values for this field can be supplied. If absent then all accounts returned.

page - Page of results to request (standard pagination)

pageSize - Page size to request. Default is 25 (standard pagination)

Returns:

ApiResponse<ResponseBankingProductList>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

listProductsAsync

public okhttp3.Call listProductsAsync(ParamEffective effective,
                                      String updatedSince,
                                      String brand,
                                      ParamProductCategory productCategory,
                                      Integer page,
                                      Integer pageSize,
                                      ApiCallback<ResponseBankingProductList> _callback)
                               throws ApiException

Get Products (asynchronously) * Obtain a list of products that are currently openly offered to the market Note that the results returned by this end point are expected to be ordered according to updated-since ### Conventions In the product reference payloads there are a number of recurring conventions that are explained here, in one place. #### Arrays Of Features In the product detail payload there are a number of arrays articulating generic features, constraints, prices, etc. The intent of these arrays is as follows: - Each element in an array has the same structure so that clients can reliably interpret the payloads - Each element as a type element that is an enumeration of the specific aspect of a product being described, such as types of fees. - Each element has a field name additionalValue. This is a generic field with contents that will vary based on the type of object being described. The contents of this field for the ADDITIONAL_CARDS feature is the number of cards allowed while the contents of this field for the MAX_LIMIT constraint would be the maximum credit limit allowed for the product. - An element in these arrays of the same type may appear more than once. For instance, a product may offer two separate loyalty programs that the customer can select from. A fixed term mortgage may have different rates for different term lengths. - An element in these arrays may contain an additionalInfo and additionalInfoUri field. The additionalInfo field is used to provide displayable text clarifying the purpose of the element in some way when the product is presented to a customer. The additionalInfoUri provides a link to externally hosted information specifically relevant to that feature of the product. - Depending on the type of data being represented there may be additional specific fields. #### URIs To More Information As the complexities and nuances of a financial product can not easily be fully expressed in a data structure without a high degree of complexity it is necessary to provide additional reference information that a potential customer can access so that they are fully informed of the features and implications of the product. The payloads for product reference therefore contain numerous fields that are provided to allow the product provider to describe the product more fully using a web page hosted on their on channels. These URIs do not need to all link to different pages. If desired, they can all link to a single hosted page and use difference HTML anchors to focus on a specific topic such as eligibility or fees. #### Linkage To Accounts From the moment that a customer applies for a product and an account is created the account and the product that spawned it will diverge. Rates and features of the product may change and a discount may be negotiated for the account. For this reason, while productCategory is a common field between accounts and products, there is no specific ID that can be used to link an account to a product within the regime. Similarly, many of the fields and objects in the product payload will appear in the account detail payload but the structures and semantics are not identical as one refers to a product that can potentially be originated and one refers to an account that actual has been instantiated and created along with the associated decisions inherent in that process. #### Dates It is expected that data consumers needing this data will call relatively frequently to ensure the data they have is representative of the current offering from a bank. To minimise the volume and frequency of these calls the ability to set a lastUpdated field with the date and time of the last update to this product is included. A call for a list of products can then be filtered to only return products that have been updated since the last time that data was obtained using the updated-since query parameter. In addition, the concept of effective date and time has also been included. This allows for a product to be marked for obsolescence, or introduction, from a certain time without the need for an update to show that a product has been changed. The inclusion of these dates also removes the need to represent deleted products in the payload. Products that are no long offered can be marked not effective for a few weeks before they are then removed from the product set as an option entirely.

Parameters:

effective - Allows for the filtering of products based on whether the current time is within the period of time defined as effective by the effectiveFrom and effectiveTo fields. Valid values are ‘CURRENT’, ‘FUTURE’ and ‘ALL’. If absent defaults to 'CURRENT'

updatedSince - Only include products that have been updated after the specified date and time. If absent defaults to include all products

brand - Filter results based on a specific brand

productCategory - Used to filter results on the productCategory field applicable to accounts. Any one of the valid values for this field can be supplied. If absent then all accounts returned.

page - Page of results to request (standard pagination)

pageSize - Page size to request. Default is 25 (standard pagination)

_callback - The callback to be executed when the API call finishes

Returns:

The request call

Throws:

ApiException - If fail to process the API call, e.g. serializing the request body object

getProductDetailCall

public okhttp3.Call getProductDetailCall(String productId,
                                         ApiCallback<ResponseBankingProductById> _callback)
                                  throws ApiException

Build call for getProductDetail

Parameters:

productId - ID of the specific product requested

_callback - The callback to be executed when the API call finishes

Returns:

Call to execute

Throws:

ApiException - If fail to serialize the request body object

getProductDetail

public ResponseBankingProductById getProductDetail(String productId)
                                            throws ApiException

Get Product Detail * Obtain detailed information on a single product offered openly to the market

Parameters:

productId - ID of the specific product requested (required)

Returns:

ResponseBankingProductById

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

getProductDetailWithHttpInfo

public ApiResponse<ResponseBankingProductById> getProductDetailWithHttpInfo(String productId)
                                                                     throws ApiException

Get Product Detail * Obtain detailed information on a single product offered openly to the market

Parameters:

productId - ID of the specific product requested (required)

Returns:

ApiResponse<ResponseBankingProductById>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

getProductDetailAsync

public okhttp3.Call getProductDetailAsync(String productId,
                                          ApiCallback<ResponseBankingProductById> _callback)
                                   throws ApiException

Get Product Detail (asynchronously) * Obtain detailed information on a single product offered openly to the market

Parameters:

productId - ID of the specific product requested (required)

_callback - The callback to be executed when the API call finishes

Returns:

The request call

Throws:

ApiException - If fail to process the API call, e.g. serializing the request body object