From 3a44c1d68eb9f31aae985f3f7e6b445221696f20 Mon Sep 17 00:00:00 2001 From: hhware Date: Sun, 15 Mar 2015 20:30:02 -0500 Subject: [PATCH] Ordering of primary data #473 --- format/index.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/format/index.md b/format/index.md index 2726d9627..bcc930200 100644 --- a/format/index.md +++ b/format/index.md @@ -825,6 +825,13 @@ The above example should return the newest articles first. Any articles created on the same date will then be sorted by their title in ascending alphabetical order. +If sorting is supported by the server and requested by the client via +query parameter `sort`, the server **MUST** return elements of the +top-level `data` array of the response ordered according to the criteria +specified. +The server **MAY** apply default sorting rules to top-level `data` +if request parameter `sort` is not specified. + ### Pagination A server **MAY** choose to limit the number of resources returned in a response