Add API output check against OpenAPI Specification in CI

[bwbroersma]

Since we found in #907 and #910 that the API output is not in line with the OpenAPI Specification, add a check in the CI.

[stitch]

Perhaps a migration strategy would be first create a pydantic schema, so the output is guaranteed to match the schema. The output might be slower, so only use that schema in tests.