1) Add a depth parameter to retrieving an item thru the rest api

2) Standardize the structure of members so that client programs can consistently
   parse the return information.
3) Added a summary parameter so that client programs can easily determine if the
   information returned is summary (item type, item title) or the full meal deal

1 files changed, 4 insertions, 10 deletions

diff --git a/modules/gallery/helpers/item_rest.php b/modules/gallery/helpers/item_rest.php
index c0fc422a..72230d8b 100644
--- a/modules/gallery/helpers/item_rest.php
+++ b/modules/gallery/helpers/item_rest.php
@@ -30,6 +30,9 @@ class item_rest_Core {
    *   name=<substring>
    *     only return items where the name contains this substring
    *
+   *   depth=<number>
+   *     return the children to the depth specified.
+   *
    *   random=true
    *     return a single random item
    *
@@ -70,16 +73,7 @@ class item_rest_Core {
       $orm->where("type", "IN", explode(",", $p->type));
     }
 
-    $members = array();
-    foreach ($orm->find_all() as $child) {
-      $members[] = rest::url("item", $child);
-    }
-
-    return array(
-      "url" => $request->url,
-      "entity" => $item->as_restful_array(),
-      "members" => $members,
-      "relationships" => rest::relationships("item", $item));
+    return  $item->as_restful_array(isset($p->depth) ? $p->depth : 0);
   }
 
   static function put($request) {