Building Blocks of REST

Loading...

En provenance du cours de Google Cloud

API Design and Fundamentals of Google Cloud's Apigee API Platform

267 notes

Google Cloud

API Design and Fundamentals of Google Cloud's Apigee API Platform

267 notes

Cours 1 sur 3 dans Specialization Developing APIs with Google Cloud's Apigee API Platform

This course gives you an introductory look at the Apigee API Platform and API Design in general. We'll cover topics such as how to properly navigate through the Apigee Edge UI as well as how to approach API design and ensure industry best practices are followed. We'll also go over the Apigee Technology Stack to ensure a full understanding of all the platform components. By taking this course, you'll come to have a high level understanding of APIs and will lay the foundation for the more detailed deep dive courses later in the specialization. All supplemental materials will be be provided for offline review. If you ever wanted to learn about Apigee and APIs in general, this is the course for you!

À partir de la leçon

Module 4 - API Design Concepts

Fundamental concepts when it comes to the design of an API.

Building Blocks of REST3:02

Best Practices in API Design6:19

Product Design4:36

Rencontrer les enseignants

Google Cloud Training

Hello. In this module,

we'll cover the fundamentals of RESTful API Design so that you can

build APIs that are easy to understand for app developers.

Roy Fielding in his PhD thesis coined the term REST or "Representational State Transfer",

which is an architectural style for distributed information systems.

REST has a set of constraints,

and one of which is HATEOAS or Hypermedia as the Engine of Application State,

which means that response payloads should include hyperlinks

instructing the developer application on what action can be performed next.

This module will focus on Pragmatic REST,

which is an outside in-view of how to design

an API and may not include hyperlinks in the response payloads.

We'll use the standard HTTP semantics

and define representations that are easy to understand,

self-documented and allows your app developers to consume the API as quickly as possible.

If you think about REST on a scale of zero to three,

REST is the highest level,

level three, and Pragmatic REST is the second level.

Pragmatic REST utilizes the standard HTTP Verbs,

and the action of the verb is performed on the resource.

If you use the above concepts,

your API will be understood by anyone that understands REST.

Some of the benefits of Pragmatic REST are that it's easier to implement over

pure REST and it provides clear intent on how to consume your API.

Let's review some examples.

In this example, a GET Operation is performed on the V1 customers resource.

This request returns an array of customers.

In this example, a GET Operation is performed on

the customer's resource and the customer ID is also included in the URI.

This request returns a single customer and the response payload.

In this example, a request is being made to a deprecated version of the customer API.

Instead of an error, the response should display a message

instructing the consumer what action to take next.

In this case, the recommended approach is to return a response with

useful information and return HTTP status of 301,

moved permanently, and include the correct URL in

the location header so that the consumers can handle the redirect accordingly.

In this last example,

the client sent an If-Modified-Since header with the request to instruct

the server to send the response only if it was updated after the date in this header.

If the resource is not modified,

then a HTTP status of 304 Not Modified is returned.

In this case, the client can use the cached resource.

For more information on this topic,

refer to the links in the video description.

And if you have any questions,

please post them on the community.

Explorer notre catalogue

Rejoignez-nous gratuitement et obtenez des recommendations, des mises à jour et des offres personnalisées.

Coursera propose un accès universel à la meilleure formation au monde, en partenariat avec des universités et des organisations du plus haut niveau, pour proposer des cours en ligne.

© 2018 Coursera Inc. Tous droits réservés.

Télécharger dans l'App Store

Disponible sur Google Play