用户Token API 使用说明

WLNWIKI目前通过用户在个人中心生成用户 token 的方式来支持如下功能：

- 获取文集列表；
- 新建文档；
- 上传图片；
- 获取文集的文档列表
- 获取文档详情
WLNWIKI 地址为 `http://www.wln.wiki`，用户 `token `为` 123456`，
那么：
获取文集列表的 url 为：`http://www.wln.wiki/api/get_projects/?token=123456`
新建文档的 url 为：`http://www.wln.wiki/api/create_doc/?token=123456`
上传图片的 url 为：`http://www.wln.wiki/api/upload_img/?token=12345`

------------

### 获取用户 Token
你可以在 【个人中心】-->【Token 管理】页面生成或获取你的用户 token：

![](/media//202101/2021-01-09_124440.png)
下述所有接口都需要携带用户 token 值进行请求。

------------
### 获取文集列表
请求 `URL：/api/get_projects/`

请求方法：`GET`

请求示例 URL：`http://www.wln.wiki/api/get_projects/?token=123456`

正确响应结果：

```d
{
	'status':true,
	'data':[
		{'id':1,'name':'文集 1','type':'公开'}
	]
}
```
其中：

- id：表示文集的 ID 值，新建文档需要附带指定文集的 ID；
- name：表示文集的名称；
- type：表示文集的权限状态名称；
异常响应结果：

```d
{
	'status':false,
	'data':"异常字符串"
}
```
### 新建文档
请求 URL：/api/create_doc/

请求方法：POST

请求参数：

```d
{
	'pid':123,
	'title':'文档标题',
	'doc':'文档内容'
}
```
请求示例 URL：http://www.wln.wiki/api/create_doc/?token=123456

正确响应结果：

```d
{
	'status':true,
	'data':'ok'
}
```
异常响应结果：

```d
{
	'status':false,
	'data':"异常字符串"
}
```
### 上传图片
请求 URL：/api/upload_img/

请求方法：POST

请求参数：

```d
{
	'data':'图片的 base64 编码数据'
}
```
请求示例 URL：http://www.wln.wiki/api/upload_img/?token=123456

正确响应结果：

```d
{
	'success':1,
	'url':'图片的相对 URL'
	'message':'上传图片成功'
}
```
异常响应结果：

```d
{
	'success':0,
	'data':"异常字符串"
}
```
### 获取文集的文档列表
请求 URL：/api/get_docs/

请求方法：GET

请求参数：pid：文集 ID

请求示例 URL：http://www.wln.wiki/api/get_docs/?token=123456&pid=1

正确响应结果：

```d
{
	'status':true,
	'data':[
		{}
	]
}
```
其中：

id: 文档 ID
name:文档名称
parent_doc:上级文档
top_doc:所属文集
status:文档状态
create_time: 文档创建时间
modify_time: 文档的修改时间
create_user: 文档的创建者

异常响应结果：

```d
{
	'status':false,
	'data':"异常字符串"
}
```
### 获取单篇文档
请求 URL：/api/get_doc/

请求方法：GET

请求参数：did：文档 ID

请求示例 URL：http://www.wln.wiki/api/get_doc/?token=123456&did=1

正确响应结果：

```d
{
	'status':true,
	'data':{}
}
```
其中：

id: 文档 ID
name:文档名称
md_content:文档内容
parent_doc:上级文档
top_doc:所属文集
status:文档状态
create_time: 文档创建时间
modify_time: 文档的修改时间
create_user: 文档的创建者

异常响应结果：

```d
{
	'status':false,
	'data':"异常字符串"
}

```