From d2a7f384e345d1d16064e4b1a455da26422f9e8d Mon Sep 17 00:00:00 2001 From: Jorden Lowe Date: Thu, 19 Feb 2015 15:38:19 -0500 Subject: [PATCH] Fixed capitialization of RESTFul to RESTful, to match other instances of RESTful. --- lessons/restfulresourcenaming.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lessons/restfulresourcenaming.html b/lessons/restfulresourcenaming.html index 27e4a33..f11d896 100644 --- a/lessons/restfulresourcenaming.html +++ b/lessons/restfulresourcenaming.html @@ -53,7 +53,7 @@

In addition to utilizing the HTTP verbs appropriately, resource naming is arguably the most debated and most important concept to grasp when creating an understandable, easily leveraged Web service API. When resources are named well, an API is intuitive and easy to use. Done poorly, that same API can feel klutzy and be difficult to use and understand. Below are a few tips to get you going when creating the resource URIs for your new API.

-

Essentially, a RESTFul API ends up being simply a collection of URIs, HTTP calls to those URIs and some JSON and/or XML representations of resources, many of which will contain relational links. The RESTful principal of addressability is covered by the URIs. Each resource has its own address or URI—every interesting piece of information the server can provide is exposed as a resource. The constraint of uniform interface is partially addressed by the combination of URIs and HTTP verbs, and using them in line with the standards and conventions.

+

Essentially, a RESTful API ends up being simply a collection of URIs, HTTP calls to those URIs and some JSON and/or XML representations of resources, many of which will contain relational links. The RESTful principal of addressability is covered by the URIs. Each resource has its own address or URI—every interesting piece of information the server can provide is exposed as a resource. The constraint of uniform interface is partially addressed by the combination of URIs and HTTP verbs, and using them in line with the standards and conventions.

In deciding what resources are within your system, name them as nouns as opposed to verbs or actions. In other words, a RESTful URI should refer to a resource that is a thing instead of referring to an action. Nouns have properties as verbs do not, just another distinguishing factor.

Some example resources are: