API doc block updates

increased API version

API: proper access to the current media revision

Even when the revision is explictly given instead of set to 0. See #4419
for ponderings about why this is necessary and a different approach.

Added API endpoint core.getMediaHistory #4147

squashed commits of #4369

init rendering correctly in API

When rendering a page, the ID should be passed.

increase API version for new call, remove unused parameter

remove obsolete TODO comment

added API core.getMediaUsage

API: code style fixes

API: ApiCore tests fixed and extended

API: fix listPages

Not all needed fields are returned by the search callback

API: getPageHistory is nicer than getPageVersions

API: checkPage needs to consider revision

API: always pass revision as integer

API fix depth handling in listPages

API: initialize responses explicitly

Instead of passing unknown arrays, explicit parameters are passed.
Revision handling should now work correctly since we can pass revision=0
but a mtime.

API: clean up error codes

Error codes are now extracted from API core and printed on the OpenAPI
overview page. This makes it easier to see what is in use.

Error messages have been cleaned up, some

API: clean up error codes

Error codes are now extracted from API core and printed on the OpenAPI
overview page. This makes it easier to see what is in use.

Error messages have been cleaned up, some new codes have been assigned.

Some errors have been removed. Eg. it is fine to iterate a media
namespace you don't have read access to. The result will either be empty
or contain files from lower namespaces that you *do* have access to.

show more ...

API: Do not assume the start page for empty pageIDs

API: move create/delete user calls to usermanager

This only moves the calls. A proper refactoring of the user manager
would make sense:

1) introduce a helper component covering the basic operations

API: move create/delete user calls to usermanager

This only moves the calls. A proper refactoring of the user manager
would make sense:

1) introduce a helper component covering the basic operations including
proper error signalling using Exceptions
2) refactor admin and cli components to make use of 1)
3) make the operations in 1) available via the API

show more ...

Reworked API definition

This cleans up the API:

* no more compatibility with obsolete wiki API
* no more difference between wiki.* and dokuwiki.* calls -> core.*
* use of optional parameters avoids

Reworked API definition

This cleans up the API:

* no more compatibility with obsolete wiki API
* no more difference between wiki.* and dokuwiki.* calls -> core.*
* use of optional parameters avoids double definitions
* use Response objects for complex results
* always use named primitives as input
* major cleanup of docblock descriptions

show more ...

OpenAPI Gen: handle Object to Schema transformation correctly

All the basic mechanisms should now be in place to clean up the API

OpenAPI Generator. Better DocBlock parsing [WIP]

This introduces a new DocBlock parser to properly generate API
specifications. It also introduces the concept of Response classes to
better specify t

OpenAPI Generator. Better DocBlock parsing [WIP]

This introduces a new DocBlock parser to properly generate API
specifications. It also introduces the concept of Response classes to
better specify the response format.

This is still very much in progress.

show more ...

improved API docs

rename $id to be more clear

It should be more clear if a media or page ID is passed. Also
openapi-explorer will not prefill examples for any parameters called
*id*.

improve the doc blocks in ApiCore