Actions
action #95084
openCreate a data file with openQA API routes, parameters, docs
Start date:
2021-07-05
Due date:
% Done:
0%
Estimated time:
Description
We have several places where information on our API is stored.
- WebAPI.pm includes the route definitions for Mojolicious.
- In the actual methods, we have the
validation
object to define parameter validation. - In our documentation we have some API examples
Changing or adding things to the API often results in forgetting docs and/or validation.
Having the definitions all in one place avoids that, and can serve as documentation as well, or at least we can generate documentation from it.
Having the definitions in a data format allows to easily port to other data formats in the future, e.g. openAPI (also known as Swagger).
Updated by tinita over 3 years ago
- Related to action #16282: [tools][sprint 201711.2] documentation: Better API documentation added
Updated by livdywan over 3 years ago
I like the idea. It would be great to have a reference YAML (or equivalent). We might even be able to automated tests to for example check that API changes come with documentation changes.
Updated by okurz over 3 years ago
- Related to action #95075: Find jobs matching search parameters over /api/v1/jobs (especially documentation) size:S added
Actions