Amazon API Gateway REST API Reference

Amazon API Gateway REST API

Amazon API Gateway helps developers deliver robust, secure and scalable mobile and web application backends. Amazon API Gateway allows developers to securely connect mobile and web applications to APIs that run on AWS Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.

Hypertext Application Language

The Amazon API Gateway web service is a resource-based API that uses Hypertext Application Language (HAL). HAL provides a standard way for expressing the resources and relationships of an API as hyperlinks. Using HAL, you use HTTP methods (GET, PUT, POST, DELETE) to submit requests and receive information about the API in the response. Applications can use the information returned to explore the functionality of the API.

For example, you can inspect the JSON returned in the response from the web service on an RestApi resource to discover the resource:create link. By extracting the href property of that link, you can programmatically build the request needed to create a new resource for that API. For more information about HAL, see the JSON Hypertext Application Language draft.