Basics

• Schema
• Authentication
• Pagination

Schema

The API is accessible from a DOCman menu item in your website: https://www.example.com/downloads.

Throughout our documentation we'll use https://demo.joomlatools.com/en/docman/hierarchical-list.

Note: The API can only access the categories and documents that are accessible through the menu item.

Accept header

All data is sent and received as JSON, set the Accept request-header:

Accept: application/json

Query string

By adding format=json to the query string the representation will always be JSON data.

Example: https://demo.joomlatools.com/en/docman/hierarchical-list?format=json

Authentication

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.

Basic authentication

GET /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.

Pagination

Requests that return multiple items will be paginated to 20 items by default. You can specify pagination with the limit and offset parameters.

Parameters

Name	Type	Description	Default
limit	integer	Defines the total items that should be returned in the response	20
offset	integer	Defines the beginning of the subset of items.	0

Links

The pagination info is included in the JSON response. It is advised to follow these values instead of constructing your own URLs.

{
    "links": {
        "self": {
            "href": "https://demo.joomlatools.com/en/docman/hierarchical-list?view=documents&format=json&offset=20",
            "type": "application/json; version=1.0"
        },
        "next": {
            "href": "https://demo.joomlatools.com/en/docman/hierarchical-list?view=documents&format=json&offset=40",
            "type": "application/json; version=1.0"
        },
        "previous": {
            "href": "https://demo.joomlatools.com/en/docman/hierarchical-list?view=documents&format=json&offset=0",
            "type": "application/json; version=1.0"
        }
    }
}