API Documentation

[ralf401]

For the old docs, the REST API requests and responses are generated manually. After migrating them to the new docs, it turned out that these partially large JSON code blocks are included in the translation catalog. Is is not easily possible to exclude them from being extracted for translation. So the conclusion is to place them in separate files in the first step and include these files wherever needed. In the next step, these responses should be auto-generated based on the Zammad stack with the example data in this repository.

Another related topic is to have the GraphQL documented.