ÍST TS 312 defines web application programming interfaces implemented by Icelandic commercial and savings banks to expose shared functionality and information for currency exchange rate, under the Icelandic Online Banking Web Services (IOBWS) framework of specifications. Other ÍST Technical Specifications exist which address related but discrete units of the overall IOBWS framework, either as new additions or upgrades to the previous specifications. Some crosscutting guidelines and shared concerns are addressed in the workshop agreement ÍST WA 316. As the consumption and implementation of each part of IOBWS are optional, the documents aim to be independent of each other. The focus in ÍST TS 312 is the information needed for consuming information about foreign currency rates though the variations in client usage patterns and bank specific implementations detail result in many different use cases for said information. The intended audience for the specification document ÍST TS 312 is developers who will either implement banking API services or the systems that will consume them as API clients. The reader is expected to have a basic understanding of the Icelandic financial products involved. Further documentation on business aspects of those products will be available from each bank, as they may involve service agreements and the end customers’ contractual preferences and benefits. Out of necessity, the previous IOBWS technical specifications largely consisted of expressing the intent and actual content in a human-readable format, otherwise found in the associated XML Schema and SOAP definitions. The expectation for ÍST TS 312 is that the technical service definitions and JSON data schemas in the accompanying OpenAPI specification can be understood using utilities that can convert them into documentation or navigatable user interfaces. Consequently, the ÍST TS 312 specification avoids the unnecessary repetition of information found in the technical contract “IOBWS-Currency3.0.yaml”. Instead, the the document focuses on the information needed to understand the domestic context of services, schema types and service flows required to implement ÍST TS 312.
The joint effort to create third version of the IOBWS (Icelandic Online Banking Web Service) is described in ÍST-WA-312. This document describes the currency product and is a part of the third version of IOBWS. This document reflects the agreement made by TN-FMÞ and is based on the analysis of the working group TN-FMÞ-VH1 Business claims.
