The API is accessible from a DOCman menu item in your website:
Throughout our documentation we’ll use
Note: The API can only access the categories and documents that are accessible through the menu item.
All data is sent and received as JSON, set the Accept request-header:
format=json to the query string the representation will always be JSON data.
For some requests, like creating documents, you need to pass the user credentials to the request so that DOCman can authenticate the user.
To do that, install our basic auth plugin on your site and enable it. You can send the user credentials using basic auth and the user will automatically be logged in and authenticated.
If you are programmatically creating documents using a single user, we suggest you create a new admin user specifically for this purpose.
GET /joomla3/en/docman/hierarchical-list HTTP/1.1 Host: https://demo.joomlatools.com Accept: application/json Cache-Control: no-cache Authorization: Basic YWRtaW46YWRtaW4=
Note that the Authorization header sends the user credentials in a base64 encoded format.
Requests that return multiple items will be paginated to 20 items by default. You can specify pagination with the
| || ||Defines the total items that should be returned in the response|| |
| || ||Defines the beginning of the subset of items.|| |
The pagination info is included in the JSON response. It is advised to follow these values instead of constructing your own URLs.
Let our developers personally assist you. You can ask development related questions in our Support Center. Only for Business or Agency subscribers.