New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: update open api static spec #846
Conversation
Code Coverage (Ubuntu)
Minimum allowed coverage is Generated by 🐒 cobertura-action against 7e46328 |
Code Coverage (Windows)
Minimum allowed coverage is Generated by 🐒 cobertura-action against 7e46328 |
a9ab5d4
to
0e66de3
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Needed changes:
- /api : example to {}
- /queryables: adapt description (no CQL2)
- /collections: remove parameters
- /collections/{collectionId}/queryables: adapt description (no CQL2)
- /catalogs/{catalogPath}/items/{featureId}/download: remove "string" for 200 example value
- add /catalogs/{catalogPath}/items
- *: change 404 example
- *: add 400 code in responses
- *: change 500 response example format
c017233
to
e290527
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please describe more the query extension usage and adapt to our implementation (see #839 description). Details for accepted operators and parameters can be found in rest.utils.get_criterias_from_metadata_mapping()
that uses conf from resources/stac_provider.yml
9ab05c3
to
8dcf05b
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- put working examples that users can directly execute (no "string" values)
8dcf05b
to
a31f93f
Compare
a31f93f
to
f5f2a01
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- please restore previous server methods sorting, as some are not working any more (
/catalogs/{catalogs}/items/{item_id}/download
interpreted as/catalogs/{catalogs}
) /collections/{collection_id}/items/{item_id}
and/collections/{collection_id}/items/{item_id}/download
forms are opening together when you click on one of them ...- remove query from GET /search
- give a working example in POST /search
- give more details on searchBody in POST /search (display its description or at least a link to it)
b55c370
to
154f497
Compare
154f497
to
f998087
Compare
f998087
to
65fa018
Compare
Description
This PR updates the openAPI static file located at
./eodag/resources/stac_api.yml
, updating the description and summaries of endpoints as well as adding aquery
entry in the list of parameters.It fixes the issue #839