Migration to new api portal

What you need to do

Instructions for API business suite (ADAA - Account direct Access API)

1. Login in the new API portal

• Login to portal https://developers.kb.cz - you can use username and password from the old API Portal.

2. New Client registration (Software statements) v2

• Api key header is mandatory and renamed from x-api-key to apiKey.
• Generate new apiKey and put your app.
• The section contacts.email in the "body" part of the request is mandatory
• New url: https://client-registration.api-gateway.kb.cz/v2.
• v1 will be operational until 31.1.2024.

3. Registration OAuth2 client

• New url: https://api-gateway.kb.cz/client-registration-ui/v1/saml/

4. Authenticate your requests via the new Oauth2 v2 API

• Api key header is mandatory and renamed from x-api-key to apiKey.
• Generate new apiKey and put your app.
• New url: https://api-gateway.kb.cz/oauth2/v2.
• v1 will be operational until 31.1.2024.

5. Account direct access v1

• Api key header renamed from x-api-key to apiKey
• Generate new apiKey and put your app.
• New url: https://api-gateway.kb.cz/adaa/v1.
• Terminate the endpoint /account-ids → replaced by /accounts,
  • the endpoint /account-ids will be operational until 31.1.2024.

Instructions for other APIs (Exchange Rates, Branches and ATMs, Contact Requests, etc.)

1. Login in the new API portal

• Login to portal https://developers.kb.cz - you can use username and password from the old API Portal.

2. Open API and create apiKey

• Rename the header x-api-key to apiKey ("x-api-key" will no longer work).
• Generate new apiKey and replace it in your app.
• Copy new url (replace old one in your app).