Overview
CentraSite's REST framework enables you to model APIs conforming to the (Resource Oriented Architecture) ROA design. For example, you might model an API that serves to expose the web service data and functionality as a collection of resources. Each resource will be accessible with unique Uniform Resource Identifiers (URLs). In your API, you expose a set of HTTP operations (methods) to perform on a specific resource, and capture the request and response messages, and status codes that will be unique to the HTTP method and linked within the specific resource of the API.
The basic elements of a REST API in the CentraSite registry are as follows:
![*](bullet.gif)
The API itself (For example,
phonestore)
![*](bullet.gif)
Its resource (
phones), available on the unique base URL (
/phones)
![*](bullet.gif)
The defined HTTP method (
GET) for accessing the resource (
phones)
![*](bullet.gif)
Parameters for request representations (
412456)
![*](bullet.gif)
A request generated for this method (
Request 123)
![*](bullet.gif)
A response with the status code received for this request (
Response ABCD)
Instructions throughout this guide use the term API when referring to the REST APIs.