The servers field of each spec only lists a single test URL for each API, instead of actually specifying the pattern of URLs used.
This is inconvenient, as some tools (such as HTTP Toolkit - I'm the maintainer) use the servers listed in the spec to recognise traffic to an API, and provide appropriate tooling for the API in that case.
For Adyen right now that isn't possible - nobody can use these spec for anything relating to traffic to Adyen production APIs, only to your test APIs (still useful, but very limiting).
The specs should also include the pattern of the production base URL, using variables for the potentially variable component, for example something like:
"servers": [
{
"url" : "https://checkout-test.adyen.com/v70",
"description": "The test API"
},
{
"url": "https://{prefix}-checkout-live.adyenpayments.com/checkout/v70",
"description": "The production API",
"variables": {
"prefix": {
"description": "A string composed of a hex-encoded random part and your company name. Get the prefix from your live Customer Area under Developers > API URLs > Prefix"
}
}
}
]
This makes it possible to use these specs for requests to Adyen production APIs, and for tooling to recognize traffic to these APIs.
Describe the bug
The
servers
field of each spec only lists a single test URL for each API, instead of actually specifying the pattern of URLs used.This is inconvenient, as some tools (such as HTTP Toolkit - I'm the maintainer) use the servers listed in the spec to recognise traffic to an API, and provide appropriate tooling for the API in that case.
For Adyen right now that isn't possible - nobody can use these spec for anything relating to traffic to Adyen production APIs, only to your test APIs (still useful, but very limiting).
To Reproduce
Look at any spec's servers, e.g. for the checkout API: https://github.com/Adyen/adyen-openapi/blob/40452c3a83fd9b08027f80866cabd2fb5b31cbb2/json/CheckoutService-v70.json#L3-L7
This just lists the test endpoint, where the actual production URLs according to https://docs.adyen.com/development-resources/live-endpoints can include
https://[prefix]-checkout-live.adyenpayments.com/checkout/v70/
.Expected behavior
The specs should also include the pattern of the production base URL, using variables for the potentially variable component, for example something like:
This makes it possible to use these specs for requests to Adyen production APIs, and for tooling to recognize traffic to these APIs.