API Explorer

v3.1.0 (266 APIs)

Anfitrión de la API: https://api.ttk.com.mk
Banco
Cuentas
Vistas
Contrapartes
Transacciones

Create Product

Create or Update Product for the Bank.

Typical Super Family values / Asset classes are:

Debt
Equity
FX
Commodity
Derivative

Product hiearchy vs Product Collections:

  • You can define a hierarchy of products - so that a child Product inherits attributes of its parent Product - using the parent_product_code in Product.

  • You can define a collection (also known as baskets or buckets) of products using Product Collections.

Authentication is Mandatory

URL Parameters:

BANK_ID: gh.29.uk

PRODUCT_CODE: 1234BW

JSON response body fields:

bank_id: gh.29.uk

category:

code: 125

description: This an optional field. Maximum length is 2000. It can be any characters here.

details:

family:

id: d8839721-ad8f-45dd-9f78-2080414b93f9

license:

meta:

more_info_url: www.example.com/abc

name: ACCOUNT_MANAGEMENT_FEE

parent_product_code: 787LOW

product_attribute_id:

product_code: 1234BW

super_family:

type:

value: 5987953

product_attributes:

Respuesta Exitosa Típica:

								
									
{ "bank_id":"gh.29.uk", "code":"1234BW", "parent_product_code":"parent", "name":"product name", "category":"category", "family":"family", "super_family":"super family", "more_info_url":"www.example.com/prod1/more-info.html", "details":"Details", "description":"Description", "meta":{ "license":{ "id":"ODbL-1.0", "name":"Open Database License" } }, "product_attributes":[{ "product_code":"1234BW", "product_attribute_id":"613c83ea-80f9-4560-8404-b9cd4ec42a7f", "name":"OVERDRAFT_START_DATE", "type":"DATE_WITH_DAY", "value":"2012-04-23" }] }
Roles Requeridos:
  • CanCreateProduct - Please login to request this Role
  • CanCreateProductAtAnyBank - Please login to request this Role
Validaciones:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Posibles Errores:
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-20006: User is missing one or more roles:
  • OBP-50000: Unknown Error.
Version: OBPv3.1.0, function_name: by createProduct, operation_id: OBPv3.1.0-createProduct Tags: Product,

Create Product Attribute

Create Product Attribute

Product Attributes are used to describe a financial Product with a list of typed key value pairs.

Each Product Attribute is linked to its Product by PRODUCT_CODE

Typical product attributes might be:

ISIN (for International bonds)
VKN (for German bonds)
REDCODE (markit short code for credit derivative)
LOAN_ID (e.g. used for Anacredit reporting)

ISSUE_DATE (When the bond was issued in the market)
MATURITY_DATE (End of life time of a product)
TRADABLE

See FPML for more examples.

The type field must be one of "STRING", "INTEGER", "DOUBLE" or DATE_WITH_DAY"

Authentication is Mandatory

URL Parameters:

BANK_ID: gh.29.uk

PRODUCT_CODE: 1234BW

JSON request body fields:

name: ACCOUNT_MANAGEMENT_FEE

type:

value: 5987953

JSON response body fields:

name: ACCOUNT_MANAGEMENT_FEE

product_attribute_id:

product_code: 1234BW

type:

value: 5987953

Respuesta Exitosa Típica:

								
									
{ "product_code":"1234BW", "product_attribute_id":"613c83ea-80f9-4560-8404-b9cd4ec42a7f", "name":"OVERDRAFT_START_DATE", "type":"DATE_WITH_DAY", "value":"2012-04-23" }
Roles Requeridos:
  • CanCreateProductAttribute - Please login to request this Role
Validaciones:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Posibles Errores:
  • OBP-10001: Incorrect json format.
  • OBP-50000: Unknown Error.
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
Version: OBPv3.1.0, function_name: by createProductAttribute, operation_id: OBPv3.1.0-createProductAttribute Tags: Product,

Delete Product Attribute

Delete Product Attribute

Product Attributes are used to describe a financial Product with a list of typed key value pairs.

Each Product Attribute is linked to its Product by PRODUCT_CODE

Delete a Product Attribute by its id.

Authentication is Mandatory

URL Parameters:

BANK_ID: gh.29.uk

PRODUCT_ATTRIBUTE_ID:

PRODUCT_CODE: 1234BW

JSON response body fields:

Respuesta Exitosa Típica:

								
									
Roles Requeridos:
  • CanUpdateProductAttribute - Please login to request this Role
Validaciones:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Posibles Errores:
  • OBP-20006: User is missing one or more roles:
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-50000: Unknown Error.
  • OBP-20001: User not logged in. Authentication is required!
Version: OBPv3.1.0, function_name: by deleteProductAttribute, operation_id: OBPv3.1.0-deleteProductAttribute Tags: Product,

Get Bank Product

Returns information about a financial Product offered by the bank specified by BANK_ID and PRODUCT_CODE including:

  • Name
  • Code
  • Parent Product Code
  • Category
  • Family
  • Super Family
  • More info URL
  • Description
  • Terms and Conditions
  • License the data under this endpoint is released under

Authentication is Optional

URL Parameters:

BANK_ID: gh.29.uk

PRODUCT_CODE: 1234BW

JSON response body fields:

bank_id: gh.29.uk

category:

code: 125

description: This an optional field. Maximum length is 2000. It can be any characters here.

details:

family:

id: d8839721-ad8f-45dd-9f78-2080414b93f9

license:

meta:

more_info_url: www.example.com/abc

name: ACCOUNT_MANAGEMENT_FEE

parent_product_code: 787LOW

product_attribute_id:

product_code: 1234BW

super_family:

type:

value: 5987953

product_attributes:

Respuesta Exitosa Típica:

								
									
{ "bank_id":"gh.29.uk", "code":"1234BW", "parent_product_code":"parent", "name":"product name", "category":"category", "family":"family", "super_family":"super family", "more_info_url":"www.example.com/prod1/more-info.html", "details":"Details", "description":"Description", "meta":{ "license":{ "id":"ODbL-1.0", "name":"Open Database License" } }, "product_attributes":[{ "product_code":"1234BW", "product_attribute_id":"613c83ea-80f9-4560-8404-b9cd4ec42a7f", "name":"OVERDRAFT_START_DATE", "type":"DATE_WITH_DAY", "value":"2012-04-23" }] }
Validaciones:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Posibles Errores:
  • OBP-30011: Product not found. Please specify a valid value for PRODUCT_CODE.
  • OBP-50000: Unknown Error.
Version: OBPv3.1.0, function_name: by getProduct, operation_id: OBPv3.1.0-getProduct Tags: Product,

Get Product Attribute

Get Product Attribute

Product Attributes are used to describe a financial Product with a list of typed key value pairs.

Each Product Attribute is linked to its Product by PRODUCT_CODE

Get one product attribute by its id.

Authentication is Mandatory

URL Parameters:

BANK_ID: gh.29.uk

PRODUCT_ATTRIBUTE_ID:

PRODUCT_CODE: 1234BW

JSON response body fields:

name: ACCOUNT_MANAGEMENT_FEE

product_attribute_id:

product_code: 1234BW

type:

value: 5987953

Respuesta Exitosa Típica:

								
									
{ "product_code":"1234BW", "product_attribute_id":"613c83ea-80f9-4560-8404-b9cd4ec42a7f", "name":"OVERDRAFT_START_DATE", "type":"DATE_WITH_DAY", "value":"2012-04-23" }
Roles Requeridos:
  • CanGetProductAttribute - Please login to request this Role
Validaciones:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Posibles Errores:
  • OBP-20006: User is missing one or more roles:
  • OBP-50000: Unknown Error.
  • OBP-20001: User not logged in. Authentication is required!
Version: OBPv3.1.0, function_name: by getProductAttribute, operation_id: OBPv3.1.0-getProductAttribute Tags: Product,

Get Product Tree

Returns information about a particular financial product specified by BANK_ID and PRODUCT_CODE
and it's parent product(s) recursively as specified by parent_product_code.

Each product includes the following information.

  • Name
  • Code
  • Parent Product Code
  • Category
  • Family
  • Super Family
  • More info URL
  • Description
  • Terms and Conditions
  • License: The licence under which this product data is released. Licence can be an Open Data licence such as Open Data Commons Public Domain Dedication and License (PDDL) or Copyright etc.

Authentication is Optional

URL Parameters:

BANK_ID: gh.29.uk

PRODUCT_CODE: 1234BW

JSON response body fields:

bank_id: gh.29.uk

category:

code: 125

description: This an optional field. Maximum length is 2000. It can be any characters here.

details:

family:

id: d8839721-ad8f-45dd-9f78-2080414b93f9

license:

meta:

more_info_url: www.example.com/abc

name: ACCOUNT_MANAGEMENT_FEE

super_family:

parent_product:

Respuesta Exitosa Típica:

								
									
{ "bank_id":"testBank2", "code":"PRODUCT_CODE", "name":"product name", "category":"category", "family":"family", "super_family":"super family", "more_info_url":"www.example.com/prod1/more-info.html", "details":"Details", "description":"Description", "meta":{ "license":{ "id":"ODbL-1.0", "name":"Open Database License" } }, "parent_product":{ "bank_id":"testBank2", "code":"PARENT_CODE", "name":"product name", "category":"category", "family":"family", "super_family":"super family", "more_info_url":"www.example.com/prod1/more-info.html", "details":"Details", "description":"Description", "meta":{ "license":{ "id":"ODbL-1.0", "name":"Open Database License" } }, "parent_product":{ "bank_id":"testBank2", "code":"GRANDPARENT_CODE", "name":"product name", "category":"category", "family":"family", "super_family":"super family", "more_info_url":"www.example.com/prod1/more-info.html", "details":"Details", "description":"Description", "meta":{ "license":{ "id":"ODbL-1.0", "name":"Open Database License" } } } } }
Validaciones:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Posibles Errores:
  • OBP-30011: Product not found. Please specify a valid value for PRODUCT_CODE.
  • OBP-50000: Unknown Error.
Version: OBPv3.1.0, function_name: by getProductTree, operation_id: OBPv3.1.0-getProductTree Tags: Product,

Get Products

Returns information about the financial products offered by a bank specified by BANK_ID including:

  • Name
  • Code
  • Parent Product Code
  • Category
  • Family
  • Super Family
  • More info URL
  • Description
  • Terms and Conditions
  • License the data under this endpoint is released under

Can filter with attributes name and values.
URL params example: /banks/some-bank-id/products?manager=John&count=8

Authentication is Optional

URL Parameters:

BANK_ID: gh.29.uk

JSON response body fields:

bank_id: gh.29.uk

category:

code: 125

description: This an optional field. Maximum length is 2000. It can be any characters here.

details:

family:

id: d8839721-ad8f-45dd-9f78-2080414b93f9

license:

meta:

more_info_url: www.example.com/abc

name: ACCOUNT_MANAGEMENT_FEE

parent_product_code: 787LOW

product_attribute_id:

product_code: 1234BW

products:

super_family:

type:

value: 5987953

product_attributes:

Respuesta Exitosa Típica:

								
									
{ "products":[{ "bank_id":"gh.29.uk", "code":"1234BW", "parent_product_code":"parent", "name":"product name", "category":"category", "family":"family", "super_family":"super family", "more_info_url":"www.example.com/prod1/more-info.html", "details":"Details", "description":"Description", "meta":{ "license":{ "id":"ODbL-1.0", "name":"Open Database License" } }, "product_attributes":[{ "product_code":"1234BW", "product_attribute_id":"613c83ea-80f9-4560-8404-b9cd4ec42a7f", "name":"OVERDRAFT_START_DATE", "type":"DATE_WITH_DAY", "value":"2012-04-23" }] }] }
Validaciones:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Posibles Errores:
  • OBP-30001: Bank not found. Please specify a valid value for BANK_ID.
  • OBP-30011: Product not found. Please specify a valid value for PRODUCT_CODE.
  • OBP-50000: Unknown Error.
Version: OBPv3.1.0, function_name: by getProducts, operation_id: OBPv3.1.0-getProducts Tags: Product,

Update Product Attribute

Update Product Attribute.

Product Attributes are used to describe a financial Product with a list of typed key value pairs.

Each Product Attribute is linked to its Product by PRODUCT_CODE

Update one Product Attribute by its id.

Authentication is Mandatory

URL Parameters:

BANK_ID: gh.29.uk

PRODUCT_ATTRIBUTE_ID:

PRODUCT_CODE: 1234BW

JSON response body fields:

name: ACCOUNT_MANAGEMENT_FEE

product_attribute_id:

product_code: 1234BW

type:

value: 5987953

Respuesta Exitosa Típica:

								
									
{ "product_code":"1234BW", "product_attribute_id":"613c83ea-80f9-4560-8404-b9cd4ec42a7f", "name":"OVERDRAFT_START_DATE", "type":"DATE_WITH_DAY", "value":"2012-04-23" }
Roles Requeridos:
  • CanUpdateProductAttribute - Please login to request this Role
Validaciones:
  • Required JSON Validation: No
  • Allowed Authentication Types: Not set
Posibles Errores:
  • OBP-20006: User is missing one or more roles:
  • OBP-50000: Unknown Error.
  • OBP-20001: User not logged in. Authentication is required!
Version: OBPv3.1.0, function_name: by updateProductAttribute, operation_id: OBPv3.1.0-updateProductAttribute Tags: Product,