I maintain meraki-client-python, a type-safe Python SDK generated from the Dashboard API OpenAPI spec. I've had to accumulate a number of spec overrides to work around inaccuracies in the spec. The full list of affected endpoints is documented in spec_overrides.toml.
The issues I've encountered include:
- Endpoints returning arrays where the spec declares an object
- Endpoints missing pagination parameters despite returning paginated responses
- Paginated response wrapper schemas modeled incorrectly
- Nullable responses not declared as such
- Incorrect field types in response schemas
- Fields consistently present in responses not marked as
required
- Fields returned by the API missing from the spec entirely
- Endpoints with a bare
{type: object} response schema and no properties defined
What is the best way to get fixes like these upstreamed into the spec? Are pull requests accepted, or is there another process?
Happy to help if PRs are welcome. Thanks!
I maintain meraki-client-python, a type-safe Python SDK generated from the Dashboard API OpenAPI spec. I've had to accumulate a number of spec overrides to work around inaccuracies in the spec. The full list of affected endpoints is documented in
spec_overrides.toml.The issues I've encountered include:
required{type: object}response schema and no properties definedWhat is the best way to get fixes like these upstreamed into the spec? Are pull requests accepted, or is there another process?
Happy to help if PRs are welcome. Thanks!