DokuWiki provides a Remote API which can be used to access/interact with your wiki from other applications.

The API is disabled by default and needs to be enabled by an administrator before it can be used.

1. Enable the remote option in the configuration manager
2. Configure a list of comma separated user and/or groups that are allowed to access the API in the remoteuser option
3. If you plan to have your API used from client side JavaScript applications you may want to configure the CORS header settings in the remotecors option.

DokuWiki offers two protocols to interact with the Remote API. Refer to their respective documentation pages to learn more:

1. XML-RPC
2. JSON-RPC

The latter is the recommended, more modern interface.

Nearly all call need to be made authenticated as a valid DokuWiki user. The preferred method for API access is Token Auth. Please refer to Authentication to learn more.

API calls are divided into two namespaces:

• core.* are calls provided by the DokuWiki core itself
• plugin.<pluginname>.* are calls provided by remote plugins, this includes calls provided by some of the bundled plugins

Please refer to the API Explorer to read the documentation of available calls.

You can also open the API Explorer on your own wiki instance. This way you will see all plugin.* calls available at your instance. To do so open the following URL in your web browser:

• https://yourwiki/dokuwiki/lib/exe/openapi.php

Of course replace yourwiki/dokuwiki with the server and path your wiki is available at.

Any errors occurring in an API call will be signaled by errors with an appropriate error code.

Error codes are meant to be unique per type of error and namespace. This means one specific error code will have the same meaning in any of the core.* calls, but might mean something different when returned by a plugin.<something>.* call.

• Core error codes are listed in the API Explorer
• Plugin error codes should be listed on their respective documentation page
• API framework codes are listed below

Negative codes signal errors which occurred even before the call could be routed to a specific API call handler.

• -32600 → Invalid request. Not conforming to specification.
• -32601 → Requested method does not exist.
• -32602 → Wrong number of parameters or invalid method parameters.
• -32603 → Not authorized to call the requested method (No login or invalid login data was given).
• -32604 → Forbidden to call the requested method (but a valid login was given).
• -32605 → The API has not been enabled in the configuration
• -32700 → Parse Error. Request not well formed.
• -32800 → Recursive calls to system.multicall are forbidden.
• -99999 → Unknown server error.

Please refer to remote plugins to learn how to add calls to the API.

If you want to implement your own transport layer (REST, SOAP, gRPC, …) you need to implement your endpoint (could be any file in a plugin) which instantiates the \dokuwiki\Remote\Api.

<?php
// get the api
$remote = new dokuwiki\Remote\Api();
 
// Parse the incoming call
...
 
// call the business logic 
$result = $remote->call('core.getVersion');
 
// or with parameters
$result = $remote->call('core.deleteMedia', ['file'=>'anImage.jpg']);
 
// deliver the result

Best refer to the source of inc/Remote/JsonRpcServer.php as an example starting point.