example: named endpoints

Author: LinusU

API Blueprint Specification.md

@@ -540,7 +540,7 @@ Defined by a resource [name (identifier)](#def-identifier) followed by an [HTTP
 
     # <identifier> [<HTTP request method> <URI template>]
 
-> **NOTE:** In the two latter cases the rest of this section represents the [Action section](#def-action-section) including its description and nested sections and **follows the rules of Action section instead**.
+> **NOTE:** In the latter two cases the rest of this section represents the [Action section](#def-action-section) including its description and nested sections and **follows the rules of Action section instead**.
 
 #### Description
 An API [resource](http://www.w3.org/TR/di-gloss/#def-resource) as specified by its *URI* or a set of resources (a resource template) matching its *URI template*.

examples/12. Advanced Action.md

@@ -6,6 +6,7 @@ A resource action is – in fact – a state transition. This API example demons
 ## API Blueprint
 + [Previous: Resource Model](11.%20Resource%20Model.md)
 + [This: Raw API Blueprint](https://raw.github.com/apiaryio/api-blueprint/master/examples/12.%20Advanced%20Action.md)
++ [Next: Named Endpoints](13.%20Named%20Endpoints.md)
 
 # Tasks [/tasks/tasks{?status,priority}]
 

examples/13. Named Endpoints.md

@@ -0,0 +1,42 @@
+FORMAT: 1A
+
+# Named Endpoints API
+This API example demonstrates how to define a standalone endpoint with an identifier.
+
+## API Blueprint
++ [Previous: Advanced Action](12.%20Advanced%20Action.md)
++ [This: Raw API Blueprint](https://raw.github.com/apiaryio/api-blueprint/master/examples/13.%20Named%20Endpoints.md)
+
+# Group Quick start
+
+## Create message [POST /messages]
+
+Start out by creating a message for the world to see.
+
++ Request (application/json)
+
+        { "message": "Hello World!" }
+
++ Response 201
+
+    + Headers
+
+            Location: /messages/1337
+
+## Create a new task [POST /tasks]
+
+Now create a task that you need to do at a later date.
+
++ Request (application/json)
+
+        {
+            "name": "Exercise in gym",
+            "done": false,
+            "type": "task"
+        }
+
++ Response 201
+
+    + Headers
+
+            Location: /tasks/1992