develonly

note this is currently experimental. Feedback via Github issues is welcome. The interface might still change.

This API provides access to all remote API functionality described in XML-RPC using a more modern JSON based API.

1. Set the remote option to enable JSON-RPC in the Configuration Settings “Authentication” section
2. Set the remoteuser option with a mix of comma separated “usernames,@groups”
3. For security reasons it's safer to allow access to the JSON-RPC over HTTPS only. DokuWiki's .htaccess.dist contains some rewrite rules to do that.
4. If you want to access the API from JavaScript, you might want to tune the remotecors option

You can access the JSON-RPC interface via the following URL:

http(s)://<your wiki/domain/ip>/lib/exe/jsonrpc.php

The function you want to call has to be given as a path segment:

http(s)://<your wiki/domain/ip>/lib/exe/jsonrpc.php/<function>

All parameters are passed as a JSON Array in the body of the request.

Here is an example of how to communicate with the API using curl:

curl http://localhost/dokuwiki/lib/exe/jsonrpc.php/wiki.getPageInfo \
   -H 'Content-Type: application/json' \
   -H "Authorization: Bearer $token" \
   -d '["wiki:syntax"]'

Please note that the above uses token authentication. Authentication via Basic Auth or Cookies would also work.

Please refer to the description at XMLRPC.