Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

translate5 provides a REST API to create, read and manipulate all stored data. REST is a HTTP based, resource oriented architecture. f

For further information see: http://en.wikipedia.org/wiki/Representational_state_transfer

...

Code Block
languagejs
data = {HERE-DATA-AS-JSON}-URL-ENCODED}

The whole JSON string must be URL-encoded, since the content-type "application/x-www-form-urlencoded" requires that. 

To see the use of the REST API in action, a developer may have a look on the way translate5 JS-GUI frontend uses the REST API through tools like Firebug. This way it is easy for a programmer, to understand the way it works and to see, which values are used for which resources in which situations.

API backwards compatibility over different application versions

Note

We try to keep a backwards compatibility of the existing API. If the API changes in an incompatible manner this is listed explicitly in the "important release notes" section of each releases changelog.

Adding new fields to an entity is not considered as incompatible change. But if a field is being removed, renamed or the data format changes, this is considered as incompatible change.

Each answer of the API contains a HTTP header field "X-Translate5-Version" which contains the current version of translate5.

Filtering

All GET calls without an ID provide a list of resources. With the GET Parameter “filter” this list can be filtered. In general all fields are filterable. Exceptions in single cases.

...

Please note, that via API translate5 can be integrated in "Editor only usage", meaning that you can use only the editing component of translate5 and do the user management and task management elsewhere. Please see here.