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.
CMIS REST API
Use the CMIS REST API to for use cases that require portability.