query catalogue via openapi page is not easy...

[pvgenuchten]

the openapi page offers capability to build an items query request. But there are some challenges with that approach, which maybe can be optimized with defaults or docs?

• for users not aware of OGCAPI, the concept of collections and items may be unexpected, especcially the collections may benefit from some explanation of terms

• the collection metadata:main is not advertised, users need to first understand that this is the collection they are interested in. Suggestion to set metadata:main as a default value or as a comment

• the filter object has a default value of {}, which, when used, causes a server error:

{
  "code": "InvalidParameterValue",
  "description": "CQL parsing error: Unexpected token Token('$END', '') at line 1, column 1.\nExpected one of: \n\t* LINESTRING\n\t* ...
}