Why do the Apigee Open Banking Sample APIs have the full semantic version in the endpoint path?

Not applicable

Hi All,

My question is in relation to Open Banking and the sample APIs.

All of the "Sandbox URLs" are semantically versioned which "kinda" goes against the "principles" of URL versioning - ie, you want your URIs to be as stable as possible and including "patch" and "minor" version changes in your URL would equate to "breaking changes".

If you take a look at

https://openbank.apigee.io/account-apis-v1-0-1/apis/post/account-requests

it has the Sandbox Endpoint URL of:

https://apis-bank-test.apigee.net/ais/open-banking/v1.0.1/account-requests

And same applies for

https://openbank.apigee.io/products-apis-v1-0/apis/get/products

It has the URL of:

https://apis-bank-test.apigee.net/apis/v2.0.1/products

But the second example is even more confusing because it has a "v1" in the URL of the dev portal page, and a "v2" for the endpoint URL.

Is the use of semantic versions in the URL for the endpoint something that comes from the Open Banking / PSD2 standard (I haven't been able to find anything), or is it just an oversight?

Thanks in advance.

0 1 144
1 REPLY 1

Just a design choice, i think. AFAIK not part of PSD2 or UK OB.