diff --git a/README.md b/README.md
index 76cc8326..bc6ba2ce 100755
--- a/README.md
+++ b/README.md
@@ -110,10 +110,10 @@
授权认证
- 数据表模块
+ 数据表模块
- 内容模块
+ 内容模块
文件模块
@@ -128,17 +128,17 @@
-
授权认证
-
- 数据表模块
+ 数据表模块
-
- 内容模块
+ 内容模块
-
文件模块
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 @@
-# 数据模块
+# 数据表模块
* [数据表操作](./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 @@
-# 知晓云运营 API
+# 运营后台 API
-知晓云支持开发者结合 User Dash API 按需编写一套独立的运营后台,供并非开发者的用户使用。
+知晓云支持开发者结合 User Dash API 按需编写一套独立的运营后台,供非开发者的用户使用。
若遇到问题,请联系 或者客服(微信号: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
+
+
+```
+
+示例:
+
+```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 @@
-# 数据模块
+# 数据表模块
* [数据表操作](./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
+}
+```