From 530fe7370184270f83820586d65d51adc22b1a75 Mon Sep 17 00:00:00 2001
From: mengxucong <mengxucong@ifanr.com>
Date: Thu, 8 Mar 2018 19:54:40 +0800
Subject: [PATCH] Modify api docs

---
 README.md                             |  10 +--
 SUMMARY.md                            |   3 +-
 open-api/content/content-category.md  |  16 ++--
 open-api/content/content.md           |  22 ++---
 open-api/data/README.md               |   2 +-
 open-api/user.md                      |   7 +-
 user-dash/README.md                   |   4 +-
 user-dash/authentication.md           |  29 +++++++
 user-dash/content/content-category.md |  18 ++---
 user-dash/content/content.md          |  22 ++---
 user-dash/data/README.md              |   2 +-
 user-dash/data/record.md              |  36 +--------
 user-dash/user.md                     | 112 ++++++++++++++++----------
 13 files changed, 154 insertions(+), 129 deletions(-)
 create mode 100644 user-dash/authentication.md

diff --git a/README.md b/README.md
index 76cc8326..bc6ba2ce 100755
--- a/README.md
+++ b/README.md
@@ -110,10 +110,10 @@
           <a href="/open-api/authentication.md/">授权认证</a>
         </li>
         <li>
-          <a href="/open-api/record.md/">数据表模块</a>
+          <a href="/open-api/data/README.md/">数据表模块</a>
         </li>
         <li>
-          <a href="/open-api/content.md/">内容模块</a>
+          <a href="/open-api/content/README.md/">内容模块</a>
         </li>
         <li>
           <a href="/open-api/file/README.md/">文件模块</a>
@@ -128,17 +128,17 @@
     </li>
     <li>
       <h3>
-        <a href="/user-dash/README.md/">知晓云运营 API</a>
+        <a href="/user-dash/README.md/">运营后台 API</a>
       </h3>
       <ul class="doc-user-dash doc-detail-item">
         <li>
           <a href="/user-dash/authentication.md/">授权认证</a>
         </li>
         <li>
-          <a href="/user-dash/record.md/">数据表模块</a>
+          <a href="/user-dash/data/README.md/">数据表模块</a>
         </li>
         <li>
-          <a href="/user-dash/content.md/">内容模块</a>
+          <a href="/user-dash/content/README.md/">内容模块</a>
         </li>
         <li>
           <a href="/user-dash/file/README.md/">文件模块</a>
diff --git a/SUMMARY.md b/SUMMARY.md
index 0def1d96..4541ef21 100755
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -71,7 +71,8 @@
 
 ----
 
-* [知晓云运营 API](user-dash/README.md)
+* [运营后台 API](user-dash/README.md)
+    * [授权认证](user-dash/authentication.md)
     * [数据模块](user-dash/data/README.md)
         * [数据表操作](user-dash/data/table.md)
         * [数据操作](user-dash/data/record.md)
diff --git a/open-api/content/content-category.md b/open-api/content/content-category.md
index 7aedc633..2ffa3a9c 100644
--- a/open-api/content/content-category.md
+++ b/open-api/content/content-category.md
@@ -50,14 +50,14 @@ https://cloud.minapp.com/oserve/v1/content/1/category/1/
 
 **返回参数说明**
 
-|      参数     | 说明 |
-| :-------------| :------ |
-| id            | 分类 ID |
-| name          | 分类名称 |
-| parent        | 分类的父类 |
-| subcategories | 子类名称 |
-| created_at    | 分类创建时间 |
-| updated_at    | 分类更新时间 |
+|      参数     |      类型     |   说明   |
+| :-------------| :----------- | :------ |
+| id            | Integer      | 分类 ID |
+| name          | String       | 分类名称 |
+| parent        | Object       | 分类的父类 |
+| subcategories | Object Array | 子类名称 |
+| created_at    | Integer      | 分类创建时间 |
+| updated_at    | Integer      | 分类更新时间 |
 
 ## 获取内容分类列表
 
diff --git a/open-api/content/content.md b/open-api/content/content.md
index 33ed8f3f..09b4d879 100644
--- a/open-api/content/content.md
+++ b/open-api/content/content.md
@@ -49,17 +49,17 @@ https://cloud.minapp.com/oserve/v1/content/1/text/1/
 
 **返回参数说明**
 
-|      参数    | 说明  |
-| :---------- | :---- |
-| id          | 内容 ID |
-| title       | 内容标题 |
-| content     | 详细容 |
-| cover       | 封面图 |
-| description | 内容摘要 |
-| group_id    | 内容库 ID |
-| categories  | 内容所属分类 |
-| created_at  | 内容创建时间 |
-| updated_at  | 内容更新时间 |
+|      参数    |     类型     |   说明 |
+| :---------- | :----------- | :---- |
+| id          | Integer      |  内容 ID |
+| title       | String       |  内容标题 |
+| content     | String       |  详细容 |
+| cover       | String       |  封面图 |
+| description | String       |  内容摘要 |
+| group_id    | Integer      |  内容库 ID |
+| categories  | Object Array |  内容所属分类 |
+| created_at  | Integer      |  内容创建时间 |
+| updated_at  | Integer      |  内容更新时间 |
 
 
 ## 获取内容列表
diff --git a/open-api/data/README.md b/open-api/data/README.md
index 3b6fd9d2..8c8e5ea1 100644
--- a/open-api/data/README.md
+++ b/open-api/data/README.md
@@ -1,6 +1,6 @@
 <!-- ex_nonav -->
 
-# 数据模块
+# 数据表模块
 
 * [数据表操作](./table.md)
 * [数据操作](./record.md)
diff --git a/open-api/user.md b/open-api/user.md
index 5faa13a3..2d877a2a 100644
--- a/open-api/user.md
+++ b/open-api/user.md
@@ -67,8 +67,7 @@ request(opt, function(err, res, body) {
 
 `GET https://cloud.minapp.com/oserve/v1/miniapp/user-profile/`
 
-**参数说明
-**
+**参数说明**
 
 | 参数        | 类型   | 必填 | 说明 |
 | :--------- | :----- | :-- | :-- |
@@ -107,7 +106,7 @@ https://cloud.minapp.com/oserve/v1/miniapp/user-profile/
 var request = require('request');
 
 var opt = {
-  uri: 'https://cloud.minapp.com/oserve/v1/miniapp/user-profile/', 
+  uri: 'https://cloud.minapp.com/oserve/v1/miniapp/user-profile/',
   method: 'GET',
   headers: {
     Authorization: `Bearer ${token}`,
@@ -126,4 +125,4 @@ request(opt, function(err, res, body) {
 })
 ```
 
-{% endtabs %}
\ No newline at end of file
+{% endtabs %}
diff --git a/user-dash/README.md b/user-dash/README.md
index 091e9da7..f4493d0b 100644
--- a/user-dash/README.md
+++ b/user-dash/README.md
@@ -1,7 +1,7 @@
 <!-- ex_nonav -->
 
-# 知晓云运营 API
+# 运营后台 API
 
-知晓云支持开发者结合 User Dash API 按需编写一套独立的运营后台，供并非开发者的用户使用。
+知晓云支持开发者结合 User Dash API 按需编写一套独立的运营后台，供非开发者的用户使用。
 
 若遇到问题，请联系 <minapp-support@ifanr.com> 或者客服（微信号：minsupport）
diff --git a/user-dash/authentication.md b/user-dash/authentication.md
new file mode 100644
index 00000000..9ab5ce0f
--- /dev/null
+++ b/user-dash/authentication.md
@@ -0,0 +1,29 @@
+# 授权认证
+
+## 鉴权方式
+
+用户管理后台 API 采用的 Cookie-base 的授权方式来实现用户身份的授权。
+
+## 授权流程
+
+开发者需要将以下代码片段放入用户管理后台的 .html 文件中，来完成用户身份的验证:
+
+```html
+<!-- 其中 client_id 需替换为您应用的 ClientID -->
+<script src="https://cloud.minapp.com/custom-userdash/auth/<client_id>/"></script>
+```
+
+示例：
+
+```html
+<html>
+  <head>
+    <!-- 其中 client_id 需替换为您应用的 ClientID -->
+    <script src="https://cloud.minapp.com/custom-userdash/auth/<client_id>/"></script>
+  </head>
+  <body>
+  </body>
+</html>
+```
+
+用户管理后台可能会存在多个管理页面，需要保证每个管理页面的 **head** 都加入上述代码片段，以确保页面的登录状态。
diff --git a/user-dash/content/content-category.md b/user-dash/content/content-category.md
index f5c4e780..38c111c0 100644
--- a/user-dash/content/content-category.md
+++ b/user-dash/content/content-category.md
@@ -44,14 +44,14 @@ https://cloud.minapp.com/userve/v1/content/1/category/1/
 
 **返回参数说明**
 
-|      参数     | 说明 |
-| :-------------| :------ |
-| id            | 分类 ID |
-| name          | 分类名称 |
-| parent        | 分类的父类 |
-| subcategories | 子类名称 |
-| created_at    | 分类创建时间 |
-| updated_at    | 分类更新时间 |
+|      参数     |      类型     |   说明   |
+| :-------------| :----------- | :------ |
+| id            | Integer      | 分类 ID |
+| name          | String       | 分类名称 |
+| parent        | Object       | 分类的父类 |
+| subcategories | Object Array | 子类名称 |
+| created_at    | Integer      | 分类创建时间 |
+| updated_at    | Integer      | 分类更新时间 |
 
 ## 获取内容分类列表
 
@@ -136,7 +136,7 @@ https://cloud.minapp.com/userve/v1/content/1/category/
 
 Content-Type: `application/json`
 
-|  参数  |  类型   | 必填 | 说明 |
+|  参数   |  类型   | 必填 | 说明 |
 | :----- | :-----  | :-- | :-- |
 | name   | String  |  Y  | 分类名称 |
 | parent | Integer |  N  | 父分类 ID |
diff --git a/user-dash/content/content.md b/user-dash/content/content.md
index 0fa3d035..4e978f99 100644
--- a/user-dash/content/content.md
+++ b/user-dash/content/content.md
@@ -43,17 +43,17 @@ https://cloud.minapp.com/userve/v1/content/1/text/1/
 
 **返回参数说明**
 
-|      参数    | 说明  |
-| :---------- | :---- |
-| id          | 内容 ID |
-| title       | 内容标题 |
-| content     | 详细容 |
-| cover       | 封面图 |
-| description | 内容摘要 |
-| group_id    | 内容库 ID |
-| categories  | 内容所属分类 |
-| created_at  | 内容创建时间 |
-| updated_at  | 内容更新时间 |
+|      参数    |     类型     |   说明 |
+| :---------- | :----------- | :---- |
+| id          | Integer      |  内容 ID |
+| title       | String       |  内容标题 |
+| content     | String       |  详细容 |
+| cover       | String       |  封面图 |
+| description | String       |  内容摘要 |
+| group_id    | Integer      |  内容库 ID |
+| categories  | Object Array |  内容所属分类 |
+| created_at  | Integer      |  内容创建时间 |
+| updated_at  | Integer      |  内容更新时间 |
 
 
 ## 获取内容列表
diff --git a/user-dash/data/README.md b/user-dash/data/README.md
index 3b6fd9d2..8c8e5ea1 100644
--- a/user-dash/data/README.md
+++ b/user-dash/data/README.md
@@ -1,6 +1,6 @@
 <!-- ex_nonav -->
 
-# 数据模块
+# 数据表模块
 
 * [数据表操作](./table.md)
 * [数据操作](./record.md)
diff --git a/user-dash/data/record.md b/user-dash/data/record.md
index 936d6de9..25f937e2 100644
--- a/user-dash/data/record.md
+++ b/user-dash/data/record.md
@@ -36,7 +36,7 @@ curl -X GET \
 -H "Authorization: Bearer token" \
 -H "Content-Type: application/json" \
 -G \
---data-urlencode 'where={"price":"$eq":10}' \
+--data-urlencode 'where={"price": {"$eq": 10}}' \
 https://cloud.minapp.com/userve/v1/table/1/record/
 ```
 
@@ -92,40 +92,6 @@ https://cloud.minapp.com/userve/v1/table/:table_id/record/?order_by=id
 https://cloud.minapp.com/userve/v1/table/:table_id/record/?order_by=-id
 ```
 
-**代码示例**
-
-```python
-import json
-import urllib
-
-import requests
-
-
-table_id = ''
-BASE_API = r'https://cloud.minapp.com/userve/v1/table/%s/record/' % table_id
-
-TOKEN = ''
-HEADERS = {
-  'cookie': '{{ cookie }}'
-}
-
-where_ = {
-  'price': {'$gt': 100},
-}
-
-query_ = urllib.urlencode({
-  'where': json.dumps(where_),
-  'order_by': '-id',
-  'limit': 10,
-  'offset': 0,
-})
-
-API = '?'.join((BASE_API, query_))
-
-resp_ = requests.get(API, headers=HEADERS)
-print resp_.content
-```
-
 ## 获取数据项
 
 **接口**
diff --git a/user-dash/user.md b/user-dash/user.md
index 9117f0fa..7b953cb7 100644
--- a/user-dash/user.md
+++ b/user-dash/user.md
@@ -1,52 +1,12 @@
 # 用户模块
 
-## 获取用户详情
-
-**接口**
-
-`GET https://cloud.minapp.com/userve/v1/miniapp/user-profile/:profile_id/`
-
-其中 `:profile_id` 需替换为用户 ID
-
-**代码示例**
-
-```
-curl -X GET \
--H "cookie: {{ cookie }}" \
--H "Content-Type: application/json" \
-https://cloud.minapp.com/userve/v1/miniapp/user-profile/55019/
-```
-
-**返回示例**
-
-```json
-{
-  "avatar": "https://media.ifanrusercontent.com/media/tavatar/55/c3/55c3dbebcc61891be10d29ded808c84a01dcf864.jpg",
-  "city": "Guangzhou",
-  "country": "China",
-  "created_at": 1504504504,
-  "gender": 1,
-  "id": 55019,
-  "nickname": "PCG",
-  "openid": "onzns0KsLKFyg3-VcW0GwTE652_k",
-  "unionid": "onzns0KsLKFyg3-VcW0GwTE652_k",
-  "province": "Guangdong",
-  "user_group": [
-      137
-  ],
-  "user_id": 36619758
-}
-```
-
-
 ## 获取用户列表
 
 **接口**
 
 `GET https://cloud.minapp.com/userve/v1/miniapp/user-profile/`
 
-**参数说明
-**
+**参数说明**
 
 | 参数        | 类型   | 必填 | 说明 |
 | :--------- | :----- | :-- | :-- |
@@ -74,3 +34,73 @@ curl -X GET \
 -d order_by=-created_at \
 https://cloud.minapp.com/userve/v1/miniapp/user-profile/
 ```
+
+**返回示例**
+
+```json
+{
+  "meta": {
+    "limit": 20,
+    "next": null,
+    "offset": 0,
+    "previous": null,
+    "total_count": 1
+  },
+  "objects": [
+    {
+      "avatar": "https://media.ifanrusercontent.com/media/tavatar/55/c3/55c3dbebcc61891be10d29ded808c84a01dcf864.jpg",
+      "city": "Guangzhou",
+      "country": "China",
+      "created_at": 1504504504,
+      "gender": 1,
+      "nickname": "PCG",
+      "openid": "onzns0KsLKFyg3-VcW0GwTE652_k",
+      "unionid": "onzns0KsLKFyg3-VcW0GwTE652_k",
+      "province": "Guangdong",
+      "user_group": [
+          137
+      ],
+      "user_id": 36619758
+    }
+  ]
+}
+```
+
+## 获取用户详情
+
+**接口**
+
+`GET https://cloud.minapp.com/userve/v1/miniapp/user-profile/?user_id={{user_id}}`
+
+其中 `user_id` 即用户 ID
+
+**代码示例**
+
+```
+curl -X GET \
+-H "cookie: {{ cookie }}" \
+-G \
+-d user_id=36619758 \
+-H "Content-Type: application/json" \
+https://cloud.minapp.com/userve/v1/miniapp/user-profile/
+```
+
+**返回示例**
+
+```json
+{
+  "avatar": "https://media.ifanrusercontent.com/media/tavatar/55/c3/55c3dbebcc61891be10d29ded808c84a01dcf864.jpg",
+  "city": "Guangzhou",
+  "country": "China",
+  "created_at": 1504504504,
+  "gender": 1,
+  "nickname": "PCG",
+  "openid": "onzns0KsLKFyg3-VcW0GwTE652_k",
+  "unionid": "onzns0KsLKFyg3-VcW0GwTE652_k",
+  "province": "Guangdong",
+  "user_group": [
+      137
+  ],
+  "user_id": 36619758
+}
+```