You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I'm wondering whether we can "easily" align better with OGC APIs by deprecating the endpoints entry in GET / and replace it with conformance classes in the long-term (2.0). In the short term (1.x) we would deprecate the existing functionality and add the new one.
I could imaging it working like this: Instead of specifying the method and path, you use the operation ID specified in the OpenAPI document.
For this I'm wondering, what the endpoint list is currently used for and by which software component.
JS: Used primarily in the JS client, partially in the Web Editor and the Hub. Migration is relatively easy with the new proposal.
Apart from that, there is also a user facing API to list and check endpoints (e.g. RESTCapabilities.list_features()), But it dates back from very early in the project (2018), I haven't it seen being used, I actually just found out by researching it for this issue, and it is not listed in the official API docs. I think we can safely consider this being completely unused.
there is a check if GET /service_types is supported before trying to list service types of a certain backend, in order to merge everything across the federation
The aggregator generates its own endpoint listing independently from the endpoint listings of upstream backends.
Apart from that I couldn't find anything else that could be relevant here
In general, I kind of like the old style with explicit "path": "...", "methods": [ ...] listings as it is fully self-contained.
With the "conformsTo" URLs, the client is kind of required to request and parse a whole bunch of additional URLs to get the same information.
I'm wondering whether we can "easily" align better with OGC APIs by deprecating the
endpoints
entry inGET /
and replace it with conformance classes in the long-term (2.0). In the short term (1.x) we would deprecate the existing functionality and add the new one.I could imaging it working like this: Instead of specifying the method and path, you use the operation ID specified in the OpenAPI document.
For this I'm wondering, what the endpoint list is currently used for and by which software component.
Example
Before
After
Thoughts?
The text was updated successfully, but these errors were encountered: