ezplatform-rest-reference

eZ Platform REST reference

This repository is deprecated.
See Ibexa developer documentation
for the current REST API reference.

This repository contains the REST API reference for eZ Platform.
It is built based on RESTful API Modeling Language (RAML), for more information see https://raml.org/.

The repository is separated into three directories:

• input - RAML definitions and examples of HTTP methods used in eZ Platform
• output - static HTML automatically generated from RAML definitions
• raml2html - tool for generating static HTML from RAML definitions

input

To document new REST API, you need to:

1. Add a new method with errors to input/ez.raml.
2. Add examples of request (e.g. SectionInput.xml.example) and response (e.g. Section.xml.example) to input/examples.
3. Update descriptions of request and response elements in input/ez-types.raml.

For detailed information on how to use RAML to document API, see Specification.

raml2html

Installation

Install required dependencies before use. Go to raml2html root directory and run:

To generate static HTML from RAML definitions, use the following code: