The REST API consists of two parts, the CMIS REST API, which lets you manage and access folders and files in the repository, and the Alfresco REST API, which lets you manage Alfresco-specific features such as ratings and comments, that are not covered by the CMIS standard.
- Use the CMIS REST API to manage files and folders and their generic properties in the repository. For example, if you want to read, write, modify, create, or delete a file, then this is the API you use.
- Use the Alfresco REST API to manipulate Alfresco content features that are not part of the CMIS specification. Ratings and comments are two examples of such features, and you can find a full list here.
The quickest way to get started is to use our online REST API Explorer, based on the OpenAPI initiative. It gives you full documentation for each endpoint, and a Try it out! button so you can use each method.
You make API requests by sending a URL using one of five HTTP API methods, GET, POST, PUT, DELETE, and OPTIONS. Here's an example of a request to an Alfresco on-premise instance:
You can use the REST API Explorer to make this request:
- In your web browser, navigate to https://api-explorer.alfresco.com/api-explorer/#!/sites/getSites. You'll see full documentation for the GET sites API method, including the query and body parameter formats, and the expected and error response schemas.
- At the end of the description you'll see the Try it out! button. Press it now.
You've just made your first Alfresco REST API request. You will see the request URL you've just invoked, the corresponding Curl command, the JSON response body that the Alfresco repository has returned, the HTTP response code, and the response headers:
Note this call returns a list of site entries. All lists returned by the Alfresco REST API are of this format.