Path

7x / documentation / ez publish / technical manual / 6.x / features / rest api / rest api configuration sett...


Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

REST API configuration settings

Please read on below to find an overview of the INI settings currently existing in the REST API layer:

System settings

[System]
PrefixFilterClass=ezpRestDefaultRegexpPrefixFilter
ApiPrefix=/api

API provider

[ApiProvider]
ProviderClass[]

Debug settings

[DebugSettings]
Debug=disabled

Output settings

[OutputSettings]
RendererClass[xhtml]=ezpContentXHTMLRenderer
 
[ezpRestContentController_viewContent_OutputSettings]
Template=rest_pagelayout.tpl

Cache settings

[CacheSettings]
# Global switch to enable/disable REST application cache
ApplicationCache=enabled

The ApplicationCache is set to "Enabled" as the default value if no specific value has been defined for your controller/action. If the Application cache is set to enabled the result of each service call will be cached. You can refine this with setting specific to your controller/action. The system will look for a [<controllerClass>_<action>_CacheSettings] block to check if cache can be used, and if so, which TTL to use. If this block cannot be found, the system will search at the controller level, and so look for a [<controllerClass>_CacheSettings] block.

See example block below for more information

# Basically this setting allows you to activate the cache to your controllers/actions individually
ApplicationCacheDefault=enabled
 
# Set default TTL to 10min, in seconds
DefaultCacheTTL=600
 
# Example for action "viewContent", in "ezpRestContentController" controller class
#[ezpRestContentController_viewContent_CacheSettings]
#ApplicationCache=enabled
#CacheTTL=3600
 
# Below an example for every action contained in "ezpRestContentController" controller class
#[ezpRestContentController_CacheSettings]
#ApplicationCache=enabled
#CacheTTL=1200
 
# Switch to enable/disable Routes cache with APC
RouteApcCache=enabled
# TTL for Route APC cache, in seconds
RouteApcCacheTTL=3600

Authentication

[Authentication]
RequireAuthentication=enabled
AuthenticationStyle=ezpRestOauthAuthenticationStyle
#AuthenticationStyle=ezpRestBasicAuthStyle
RequireHTTPS=disabled

Route settings

[RouteSettings]
RouteSettingImpl=ezpRestIniRouteFilter
# Pattern for the skip filter
# SkipFilter[]=controller_action;version
# If the version component is not listed version "1" is assumed.
SkipFilter[]
SkipFilter[]=ezpRestErrorController_show
SkipFilter[]=ezpRestAuthController_basicAuth
SkipFilter[]=ezpRestAuthController_oauthRequired
SkipFilter[]=ezpRestOauthTokenController_handleRequest
# Skip (auth) filter for every action in 'myController' which is of API version 2
SkipFilter[]=myController_*;2

Geir Arne Waaler (08/02/2011 9:49 am)

Geir Arne Waaler (13/04/2011 9:21 am)


Comments

There are no comments.