Contents:

• Data models
• api/v1
• api/v2

You can use provided by elDoc REST API to build add-ons for elDoc system, develop integrations between elDoc and other applications, or script interactions with elDoc. This page provides documentation for the REST resources available in elDoc, along with expected HTTP response codes and sample requests.

Authentication & Authorization

elDoc REST API authentication is based on the JWT technology. Authentication token to be provided as Authorization header with each request.

Authorization: Bearer XXXXX.YYYYY.ZZZZZ

Security principles

All accesses are based on the security rights assigned to the account on behalf of which request is executed. This is related to all parts of the API and especially for the API related to working with documents in the system: besides the assigned Roles & Groups to the user account specific accesses assigned per document are also considered by the system.

URI Structure

elDoc's REST APIs provide access to resources (data entities) via URI paths. To use a REST API, your application will make an HTTP request and parse the response. The elDoc REST API uses JSON as its communication format, and the standard HTTP methods like GET, PUT, POST and DELETE (see API descriptions below for which methods are available for each resource). URIs for elDoc's REST API resource have the following structure:

https://host:port/api/v1/api-name/resource-name/resource-path-param?param1=value1&param2=value2

Where:

• api - static part
• v1 - stands for api version to be used, like v1
• api-name - stands for the functionality name to be used
• resource-name - stands for resource or action to be called
• resource-path-param - stands for additional resource specific path params
• param1=value1 - stands for additional resource specific params

Experimental methods

Methods marked as experimental may change without an earlier notice. Please follow our release-notes and be prepared for making necessary adjustments to those methods in case required.

Special request and response headers

• X-Error - Response header contains information about error, if any present.
• X-Total-Count - Response header contains number of total items found.

Standard response codes