matomo-org / developer-documentation

Matomo Developer Website
https://developer.matomo.org
Other
54 stars 86 forks source link

Use OpenAPI standard for API documentation #787

Open ronan-hello opened 6 months ago

ronan-hello commented 6 months ago

Hi,

Is it possible for you to generate and maintain an OpenAPI documentation ? (YAML or JSON single file) I try to make a starter, but parameters objet type is complex and never documented in official documentation.

Here is the starter : https://app.swaggerhub.com/apis-docs/Openmost/Matomo/5.0.0

Regards, Ronan HELLO

satokenta940 commented 6 months ago

To generate OpenAPI documentation, you can try Apidog, which is concise and attractive. I think it will be easier to maintain.