api_albums

2 files changed, 85 insertions, 19 deletions

diff --git a/doc/api/api_albums.md b/doc/api/api_albums.md
new file mode 100644
index 000000000..230daae3c
--- /dev/null
+++ b/doc/api/api_albums.md
@@ -0,0 +1,66 @@
+API albums
+==========
+
+Description: list photo albums
+
+GET /api/z/1.0/albums
+
+
+Output:
+
+	text - textual name
+
+	total - number of photos in this album
+
+	url - web URL
+
+	urlencode - textual name, urlencoded
+
+	bin2hex - textual name using bin2hex (which is used in the web URL link)
+
+
+Example:
+
+
+	{
+	
+	    "success": true,
+	    "albums": [
+	        {
+	            "text": "/",
+	            "total": "2",
+	            "url": "https://xyz.macgirvin.com/photos/hubzilla/album/",
+	            "urlencode": "",
+	            "bin2hex": ""
+	        },
+		        {
+	            "text": "2016-01",
+	            "total": "6",
+	            "url": "https://xyz.macgirvin.com/photos/hubzilla/album/323031362d3031",
+	            "urlencode": "2016-01",
+	            "bin2hex": "323031362d3031"
+	        },
+	        {
+	            "text": "2016-02",
+	            "total": "7",
+	            "url": "https://xyz.macgirvin.com/photos/hubzilla/album/323031362d3032",
+	            "urlencode": "2016-02",
+	            "bin2hex": "323031362d3032"
+	        },
+	        {
+	            "text": "Cover Photos",
+	            "total": "5",
+	            "url": "https://xyz.macgirvin.com/photos/hubzilla/album/436f7665722050686f746f73",
+	            "urlencode": "Cover+Photos",
+	            "bin2hex": "436f7665722050686f746f73"
+	        },
+	        {
+	            "text": "Profile Photos",
+	            "total": "26",
+	            "url": "https://xyz.macgirvin.com/photos/hubzilla/album/50726f66696c652050686f746f73",
+	            "urlencode": "Profile+Photos",
+	            "bin2hex": "50726f66696c652050686f746f73"
+	        }
+	    ]
+	
+	}
diff --git a/doc/api_zot.md b/doc/api_zot.md
index 032b4e1c1..6da8cddbe 100644
--- a/doc/api_zot.md
+++ b/doc/api_zot.md
@@ -3,82 +3,82 @@ Zot API
 
 
 
-api/z/1.0/channel/export/basic
+channel/export/basic
 
 	Export channel data
 
 
 
-api/z/1.0/channel/stream
+channel/stream
 
 	Fetch channel conversation items 
 
-api/z/1.0/network/stream
+network/stream
 
 	Fetch network conversation items 
 
 
-[api/z/1.0/files](help/api/api_files)
+[files](help/api/api_files)
 
 	List file storage
 
-api/z/1.0/filemeta
+filemeta
 
 	Export file metadata for any uploaded file
 
 
-[api/z/1.0/filedata](help/api/api_filedata)
+[filedata](help/api/api_filedata)
 
 	Fetch file contents or partial contents for any uploaded file 
 
 
-api/z/1.0/file/export
+file/export
 
-api/z/1.0/file
+file
 
-api/z/1.0/albums
+[albums](help/api/api_albums)
 
 	List photo albums
 
 
-api/z/1.0/photos
+photos
 
 	list photo metadata
 
 
-api/z/1.0/photo
+photo
 
 
-[api/z/1.0/group](help/api/group)
+[group](help/api/group)
 
 	List privacy groups
 
-[api/z/1.0/group_members](help/api/group_members)
+[group_members](help/api/group_members)
 
 	List members of a privacy group
 
 
-[api/z/1.0/xchan](help/api/api_xchan)
+[xchan](help/api/api_xchan)
 
 	Global extended channel (identity) information
 
-[api/z/1.0/item/update](help/api/api_item_update)
+[item/update](help/api/api_item_update)
 
 	Create or update an item (post, activity, webpage, etc.)
 
 
-api/z/1.0/item/full
+item/full
 
 	Get all data associated with an item
 
-api/z/1.0/abook
+abook
 
 	Connections
 
-api/z/1.0/abconfig
+abconfig
 
 	Connection metadata (such as permissions)
 
-api/z/1.0/perm_allowed
+perm_allowed
 
 	Check a permission for a given xchan