Important

You are browsing documentation for version 5.0 of OroCommerce, OroCRM, and OroPlatform, maintained until August 2024 and supported until March 2026. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

API Developer Guide 

This section describes the Web API development framework for the application data. It provides the ability to define API in the YAML configuration files regardless of standards or formats. Out-of-the-box, the framework opens REST API that conforms the JSON:API specification and enables CRUD operations support for the application ORM entities.

The Web API development framework is implemented by OroApiBundle and based on the following components:

FOSRestBundle and NelmioApiDocBundle are also used for REST API.

Note

The main format for REST API is described at JSON:API. Please make sure that you are familiar with it before creating REST API for your entities.

The auto-generated documentation and sandbox for REST API is available in the /api/doc, e.g., http://demo.orocrm.com/api/doc.

By default, only custom entities, dictionaries, and enumerations are accessible through the back-office API. For how to make other entities available via the API, see Configuration Reference.