Installation Guide 

Describes how to manage the extension from a developer’s point of view.

Target group: Developers

Installation 

  1. Install the extension from TER (sources are available on our GitHub repository).

In the context of a fully Composer setup, add in your root composer.json the following lines before doing a `composer update`.

"require": {
	...
	"aoe/restler": "1.*"
}
"autoload": {
	"psr-0": {
		"Luracast\\Restler\\": "vendor/luracast/restler/vendor"
	}
},
Copied!

Because we are using a forked version of Restler (in order to be able to tag a stable version), you also need to add the following to your composer.json file.

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/AOEpeople/Restler.git"
    }
],
Copied!
  1. Configure this TYPO3-Extension (in TYPO3 Extension-Manager; e.g. enable the online documentation of your REST-API). See the "Screenshots" section as well.
  2. (Optional, but recommended) Install the TYPO3 Extension "TYPO3 Restler Examples".
  3. Make the .htaccess changes described below:

The ".htaccess" file needs to be changed in order to make the REST API available.

# Allow access to example.com/api for normal REST calls
RewriteRule ^api/(.*)$ typo3conf/ext/restler/Scripts/restler_dispatch.php [NC,QSA,L]

# Allow access to example.com/api_explorer for the online documentation of your API.
# You may want to restrict access to this URL.
RewriteRule ^api_explorer/(.*)$ typo3conf/ext/restler/Scripts/restler_dispatch.php [NC,QSA,L]
Copied!

For Nginx use following rule

location ~^/api_explorer/ {
        rewrite ^/api_explorer/(.*)$ /typo3conf/ext/restler/Scripts/restler_dispatch.php last;
}

location ~^/api/ {
        rewrite ^/api/(.*)$ /typo3conf/ext/restler/Scripts/restler_dispatch.php last;
}
Copied!

When this is done, than you can call the online documentation of your REST API via this URL:

You also can call your REST API via this URL: