API Quick Start Guide

We build APIs for the digital economy.

To keep ahead of customer demand, banks need to compose business capabilities efficiently and easily. That’s why Temenos APIs are as intuitive as they are comprehensive and powerful.

Our APIs come with fully fledged platform-neutral web components. These components are fully flexible and can be embedded in any development framework such as Angular, React or Vue. For ease of use, ​t​​​hey're fully connected to Temenos APIs and can be implemented into UI projects to accelerate development.

Our APIs include sample requests and response data for users/developers of all levels. They're written in Javascript/Typescript for the benefit of developers, and all the sources provided can be customized by the banks. Banks can extend and compose Temenos solutions productively and easily whether using the APIs directly or the web components based on our APIs.


Find out more at Everyone's Temenos APIs.

Go to our Full API Catalog.

Unified User Experience (UUX) Component Explorer

The UUX Component Explorer is a tool used to help developers understand the relationship between UUX components, API response data and other configurable elements (for example, translations). It's similar to other playground environments such as JSFiddleUUX components allow developers to rapidly build modern web apps.

Web Components

The UUX Components are stand-alone individual web components that perform specific functions used as developers' building blocks for banking applications.

Using Web Components
  • Portable and can be readily used in any framework, including those used to create the Temenos product suite.
  • Develop responsive web applications faster.
  • Easily share business components across different technologies, promoting reuse.
  • Keep up with the latest industry developments and reduce reliance on proprietary technologies.
  • Use widely available skillsets ⁠— it's just HTML, JavaScript and TypeScript.
  • Provide an upgrade path for all Temenos UI/User Agents.
Using UUX Component Explorer
Panels

The UUX Component Explorer has three panels:

  • Component

  • API Response

  • Localization

image 47

 

Navigation Bar

On the left of the Component Explorer is the navigation bar for choosing which component to explore. After making a selection the component is loaded into the Component and Localization panel, and the API Response panel is cleared ready to load data from the API for that component.

Component

This panel displays the selected UUX component of the data that has been received from the API Response panel.
See Testing for examples.

API Response

This panel has an address bar which by default contains a URL that links to the API associated with the UUX Component.It also contains controls that allows the user to fetch data from the API, or apply changes they have made directly within the API response panel.
See Testing for examples.

Localisation

This panel allows users to test different locales and to view/edit the translations provided for the component.
It allows the user to see the following for the different locales:

  • Text direction (LRT or RTL).
  • Number/currency formatting.
  • Date formatting etc.

See Testing for examples.
 

Testing

The sections below demonstrate some of the functionalities and processes of using the UUX Component Explorer.

View a list of accounts

We are going to demonstrate how to use the UUX Component Explorer to generate a component based on the information received from an initiated API in the API Response panel.

Procedure
  1. Currently in the URL address bar, we have the following link for the Account List with Balances API:
    https://innovation-hub.azurefd.net/socket/accounts

  2. Click the Fetch data button.


    fetch data

  3. The API returns a JSON object containing the data required to display the list of accounts and their balances, and this is displayed in the API Response panel.

    image 48
     

  4. In addition to this, it also generates a UI in the Component panel.
    The data has been processed and displays it in a clear, user-friendly format.

    image 49
     

To try other functionalities see our Demo page.

Editing Data

In this section we demonstrate how you can edit the data in the API Response Panel and how it effects the Component output.
To do this, we use the same data for returning a list of accounts.

Procedure:
  1. Click the Fetch data button, this returns a list of the Accounts.

    fetch data
     
  2. You can now proceed with changing some of that data. For this, we're going to change the “accountName” and the “currencyID”.

    change data

     
  3. Once you’ve made these changes, click the Apply data button to process them.

    apply data
     
  4. Instantly the changes have been implemented and displayed in the Component panel.

    Before:

    image 51


    After:
    image 52
Troubleshooting

The UUX Component Explorer has an effective function which highlights errors that may appear.
In the below example, we have renamed the “accountName” to “test” and applied the data to the component.

image 53

As result, in the Component panel, you can see the value has changed.
It has defaulted to the field name “accountName” because that is what the component is looking for.


image 54

You can view the error message in the console.

image 55

In addition to the error console, an error message will also appear in the bottom right corner of the component.

image 56

 

The error message occurred because the component was unable locate the field account name in the API response.
The benefit of this type of error is that it identifies the issue immediately in plain English, allowing users to understand the root cause and find the solution.
In addition to this, the UI has continued to function, so the user is able to continue, but may need to raise the error to developers to resolve it.

Next Steps