[关闭]
@cfygaoyang 2018-02-06T08:21:59.000000Z 字数 9625 阅读 473

(平台)SDS Common 后台管理

sds

获取token

GET /api/web/get_token?account=18888888888&verify_code=123456

GET /api/web/get_token?account=18888888888&password=123456

参数 类型 必须 说明
account 字符串 是 手机或邮箱
verify_code 字符串 是 验证码
参数 类型 必须 说明
account 字符串 是 手机或邮箱
password 字符串 是 密码

* 请求回调

  1. {
  2.     "message":{
  3.         "token_expire_in":604800,
  4.         "token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoidG9rZW4iLCJ1c2VyX2lkIjoxLCJ0b2tlbl90aW1lIjoxNTA4NDY3NDAyfQ.ps7dPdN6-16ip5f4-fgfBZ5ye9Qu6oH9ADjz0iH1nvs",
  5.         "refresh_token_expire_in":1209600,
  6.         "refresh_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaF90b2tlbiIsInVzZXJfaWQiOjEsInRva2VuX3RpbWUiOjE1MDkwNzIyMDJ9.1r6PRGStReI1YFUrgggCovF5DAiS9gWMBY8DXOi2zPs"
  7.     },
  8.     "code":0
  9. }
参数 类型 说明
token_expire_in 整形 token有效时间（秒）
token 字符串 token
refresh_token_expire_in 整形 refresh_token有效时间（秒）
refresh_token 字符串 refresh_token

刷新token

PUT /api/web/reset_token

  1. {
  2.     "refresh_token": "1234567890"
  3. }
  1. {
  2.     "message":{
  3.         "token_expire_in":604800,
  4.         "token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoidG9rZW4iLCJ1c2VyX2lkIjoxLCJ0b2tlbl90aW1lIjoxNTA4NDY3NDAyfQ.ps7dPdN6-16ip5f4-fgfBZ5ye9Qu6oH9ADjz0iH1nvs",
  5.         "refresh_token_expire_in":1209600,
  6.         "refresh_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaF90b2tlbiIsInVzZXJfaWQiOjEsInRva2VuX3RpbWUiOjE1MDkwNzIyMDJ9.1r6PRGStReI1YFUrgggCovF5DAiS9gWMBY8DXOi2zPs"
  7.     },
  8.     "code":0
  9. }
参数 类型 说明
token_expire_in 整形 token有效时间（秒）
token 字符串 token
refresh_token_expire_in 整形 refresh_token有效时间（秒）
refresh_token 字符串 refresh_token

获取验证码

GET /api/get_verify_code?account=18888888888

参数 类型 必须 说明
account 字符串 是 手机或邮箱 
  1. {
  2.     "code": 0,
  3.     "message": {
  4.         "verify_code": "123456"
  5.     }
  6. }

修改密码

PUT /web/reset_password

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "admin_password": "1234567890"
  3. }
  1. {
  2.     "code": 0,
  3.     "message": "reset_password success"
  4. }

获取管理员信息

GET /web/user

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "message": {
  3.         "id": 1,
  4.         "admin_telephone": "18656660930",
  5.         "admin_password": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXNzd29yZCI6IjEyMzQ1NiJ9.tj8r8ucscDj-q9IxWzMKSE8-HbJI2qOhqk8Nzh8RR_s",
  6.         "admin_username": "菊花",
  7.         "admin_email": "",
  8.         "admin_permission": 0,
  9.         "app_id": "71d04c96-512d-4041-b916-858333ef663e",
  10.         "created_at": "2018-01-09T11:13:02.734000",
  11.         "updated_at": "2018-01-09T12:01:51.469000"
  12.     },
  13.     "code": 0
  14. }

修改管理员用户名

PUT /web/user

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "admin_username": "菊花"
  3. }
  1. {
  2.     "message": {
  3.         "id": 1,
  4.         "admin_telephone": "18656660930",
  5.         "admin_password": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXNzd29yZCI6IjEyMzQ1NiJ9.tj8r8ucscDj-q9IxWzMKSE8-HbJI2qOhqk8Nzh8RR_s",
  6.         "admin_username": "菊花",
  7.         "admin_email": "",
  8.         "admin_permission": 0,
  9.         "app_id": "71d04c96-512d-4041-b916-858333ef663e",
  10.         "created_at": "2018-01-09T11:13:02.734000",
  11.         "updated_at": "2018-01-09T12:01:51.469000"
  12.     },
  13.     "code": 0
  14. }

管理员查询用户

GET /web/appuser?page={page}&user_telephone={user_telephone}&user_name={user_name}

参数 类型 必须 说明
user_telephone 字符串 否 手机号
user_name 字符串 否 用户名
page 整数 否 页数

备注：user_telephone优先级大于user_name，不填则搜索全部用户

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "message": {
  3.         "total": 2,
  4.         "data": [
  5.             ... ...
  6.          ],
  7.         "pages": 1,
  8.         "page_size": 20,
  9.         "current_page": 1
  10.     },
  11.     "code": 0
  12. }

管理员添加用户

POST /web/appuser

参数 类型 必须 说明
user_telephone 字符串 是 手机号
user_password 字符串 是 密码
user_name 字符串 否 用户名
user_sex 字符串 否 性别 0:女 1:男
user_birthday 字符串 否 生日
user_city 字符串 否 城市

* 请求Header

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "message": {
  3.         "user_sex": 0,
  4.         "user_id": 3,
  5.         "user_name": "13000000000",
  6.         "created_at": "2018-01-09T15:40:31.397",
  7.         "app_id": "71d04c96-512d-4041-b916-858333ef663e",
  8.         "updated_at": "2018-01-09T15:40:31.397",
  9.         "user_city": "",
  10.         "b.user_id": 3,
  11.         "b.updated_at": "2018-01-09T15:40:31.411",
  12.         "b.created_at": "2018-01-09T15:40:31.410",
  13.         "user_email": "",
  14.         "user_birthday": "",
  15.         "user_avatar": "",
  16.         "b.app_id": "71d04c96-512d-4041-b916-858333ef663e",
  17.         "user_message_id": 3,
  18.         "user_password": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXNzd29yZCI6IjEyMzQ1NiJ9.tj8r8ucscDj-q9IxWzMKSE8-HbJI2qOhqk8Nzh8RR_s",
  19.         "user_telephone": "13000000000"
  20.     },
  21.     "code": 0
  22. }

管理员修改用户

PUT /web/appuser/{user_id}

参数 类型 必须 说明
user_id 整数 是 用户ID
user_name 字符串 否 用户名
user_sex 字符串 否 性别 0:女 1:男
user_birthday 字符串 否 生日
user_city 字符串 否 城市
user_password 字符串 否 修改密码 6-16位

* 请求Header

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.   "user_sex":0,
  3.   "user_name":"王五",
  4.   "user_birthday":"2015-12-1",
  5.   "user_city": "shanghai"
  6. }
  1. {
  2.     "message": {
  3.         "user_sex": 0,
  4.         "user_id": 5,
  5.         "user_name": "王五",
  6.         "created_at": "2018-01-09T16:18:11.194",
  7.         "app_id": "71d04c96-512d-4041-b916-858333ef663e",
  8.         "updated_at": "2018-01-09T16:18:11.194",
  9.         "user_city": "shanghai",
  10.         "b.user_id": 5,
  11.         "b.updated_at": "2018-01-09T16:23:03.032",
  12.         "b.created_at": "2018-01-09T16:18:11.256",
  13.         "user_email": "",
  14.         "user_birthday": "2015-12-1",
  15.         "user_avatar": "",
  16.         "b.app_id": "71d04c96-512d-4041-b916-858333ef663e",
  17.         "user_message_id": 7,
  18.         "user_password": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXNzd29yZCI6IjEyMzQ1NiJ9.tj8r8ucscDj-q9IxWzMKSE8-HbJI2qOhqk8Nzh8RR_s",
  19.         "user_telephone": "13000000001"
  20.     },
  21.     "code": 0
  22. }

管理员删除用户

DELETE /web/appuser/{user_id}

参数 类型 必须 说明
user_id 整数 是 用户ID

* 请求Header

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "message": "success",
  3.     "code": 0
  4. }

获取反馈信息列表

GET /web/feedback?page={PAGE}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "message": {
  3.         "total": 1,
  4.         "data": [反馈信息列表],
  5.         "pages": 1,
  6.         "page_size": 20,
  7.         "current_page": 1
  8.     },
  9.     "code": 0
  10. }

单个反馈信息

GET /web/feedback/{pk}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
参数 类型 必须 说明
pk 整形 是 反馈主键 feedback_id 
  1. {
  2.     "code": 0,
  3.     "message": {反馈信息}
  4. }

编辑反馈信息

PUT /web/feedback/{pk}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "feedback_title": "标题",
  3.     "feedback_content": "描述",
  4.     "user_id": 1
  5. }
参数 类型 必须 说明
feedback_title 字符串 是 反馈标题
feedback_content 字符串 是 反馈描述
user_id 整型 是 反馈该信息的用户ID

* 请求回调

  1. {
  2.     "code": 0,
  3.     "message": {反馈信息}
  4. }

删除反馈信息

DELETE /web/feedback/{pk}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
参数 类型 必须 说明
pk 整形 是 反馈主键 feedback_id 
  1. {
  2.     "code": 0,
  3.     "message": "success"
  4. }

获取回复信息

GET /web/feedback_reply/{pk}?page={PAGE}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
参数 类型 必须 说明
pk 整形 是 反馈信息主键 feedback_id 
  1. {
  2.     "message": {
  3.         "total": 1,
  4.         "data": [回复信息列表],
  5.         "pages": 1,
  6.         "page_size": 20,
  7.         "current_page": 1
  8.     },
  9.     "code": 0
  10. }

添加回复信息

POST /web/feedback_reply/{pk}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "reply_content": "回复内容",
  3.     "feedback_status" : 1
  4. }
参数 类型 必须 说明
pk 整形 是 反馈信息主键 feedback_id
reply_content 字符串 是 回复内容
feedback_status 整形 是 反馈状态；0待处理1处理中2已关闭

* 请求回调

  1. {
  2.     "code": 0,
  3.     "message": {回复信息}
  4. }

删除回复信息

DELETE /web/feedback_reply/{pk}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
参数 类型 必须 说明
pk 整形 是 反馈信息主键 reply_id

* 请求回调

  1. {
  2.     "code": 0,
  3.     "message": "success"
  4. }

添加FAQ

POST /web/faq

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "faq_type": "类型",
  3.     "faq_title": "标题",
  4.     "faq_content": "描述"
  5. }
参数 类型 必须 说明
faq_type 字符串 否 类型
faq_title 字符串 否 标题
faq_content 字符串 否 描述 
  1. {
  2.     "message": {
  3.         "faq_id": 1,
  4.         "faq_type": "a",
  5.         "faq_title": "aaaa",
  6.         "faq_content": "bbbb"
  7.     },
  8.     "code": 0
  9. }

查询FAQ列表

GET /web/faq?app_id={app_id}

参数 类型 必须 说明
app_id 字符串 是 厂商app_id 
  1. {
  2.     "message": {
  3.         "total": 2,
  4.         "data": [
  5.             {
  6.                 "faq_id":1,
  7.                 "app_id": xxx-xxx-xxx,
  8.                 "created_at": "2017-11-06T09:45:38.299864",
  9.                 "updated_at": "2017-11-06T09:45:38.300084",
  10.                 "faq_type": "faq类型1",
  11.                 "faq_title": "faq标题1",
  12.                 "faq_content": "faq内容1"
  13.             }
  14.         ],
  15.         "pages":1,
  16.         "pages_size":20,
  17.         "current_page":1
  18.     },
  19.     "code": 0
  20. }

查询单个FAQ

GET /web/faq/{faq_id}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
参数 类型 必须 说明
faq_id 整形 是 主键 faq_id 
  1. {
  2.     "message": {
  3.         "faq_id": 1,
  4.         "faq_type": "a",
  5.         "faq_title": "aaaa",
  6.         "faq_content": "bbbb"
  7.     },
  8.     "code": 0
  9. }

编辑FAQ

PUT /web/faq/{faq_id}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
  1. {
  2.     "faq_type": "类型",
  3.     "faq_title": "标题",
  4.     "faq_content": "描述"
  5. }
参数 类型 必须 说明
faq_type 字符串 否 FAQ类型
faq_title 字符串 否 FAQ标题
faq_content 字符串 否 FAQ描述 
  1. {
  2.     "message": {
  3.         "faq_id": 1,
  4.         "faq_title": "aaaa",
  5.         "faq_content": "ccccc"
  6.     },
  7.     "code": 0
  8. }

删除FAQ

DELETE /web/faq/{faq_id}

  1. {
  2.     "Authorization" :"1234567890qwertyuio"
  3. }
参数 类型 必须 说明
faq_id 整形 是 主键 faq_id 
  1. {
  2.     "message": "success",
  3.     "code": 0
  4. }

获取轮播图列表

GET /scroll

  1. {
  2.     "message": {
  3.         "total": 1,
  4.         "data": [
  5.             {
  6.                 "scroll_id": 2,
  7.                 "app_id": "3758749b-4a05-492f-b737-08d0c142e3dc",
  8.                 "created_at": "2018-01-22T11:07:24.834000",
  9.                 "updated_at": "2018-01-22T11:07:32.258000",
  10.                 "scroll_picture": "http://img.zcool.cn/community/018d4e554967920000019ae9df1533.jpg@900w_1l_2o_100sh.jpg",
  11.                 "scroll_order": 1,
  12.                 "scroll_jump": "http://baidu.com"
  13.             }
  14.         ],
  15.         "pages": 1,
  16.         "page_size": 20,
  17.         "current_page": 1
  18.     },
  19.     "code": 0
  20. }

查询轮播图

GET /scroll/{scroll_id}

  1. {
  2.     "Authorization" : {admin_token}
  3. }
参数 类型 必须 说明
scroll_id 整形 是 主键 scroll_id

* 请求回调

  1. {
  2.     "message": {
  3.         "scroll_id": 2,
  4.         "app_id": "3758749b-4a05-492f-b737-08d0c142e3dc",
  5.         "created_at": "2018-01-22T11:07:24.834000",
  6.         "updated_at": "2018-01-22T11:07:32.258000",
  7.         "scroll_picture": "http://img.zcool.cn/community/018d4e554967920000019ae9df1533.jpg@900w_1l_2o_100sh.jpg",
  8.         "scroll_order": 1,
  9.         "scroll_jump": "http://baidu.com"
  10.     },
  11.     "code": 0
  12. }

添加轮播图

POST /web/scroll

  1. {
  2.     "Authorization" : {admin_token}
  3. }
  1. {
  2.     "scroll_picture": "http://img.zcool.cn/community/018d4e554967920000019ae9df1533.jpg@900w_1l_2o_100sh.jpg",
  3.     "scroll_order": 0,
  4.     "scroll_jump": "http://baidu.com"
  5. }
参数 类型 必须 说明
scroll_picture 字符串 是 图片url
scroll_order 整数 否 轮播顺序, 缺省为0
scroll_jump 字符串 否 跳转地址 
  1. {
  2.     "message": {
  3.         "scroll_id": 2,
  4.         "app_id": "3758749b-4a05-492f-b737-08d0c142e3dc",
  5.         "created_at": "2018-01-22T11:07:24.834000",
  6.         "updated_at": "2018-01-22T11:07:24.834000",
  7.         "scroll_picture": "http://img.zcool.cn/community/018d4e554967920000019ae9df1533.jpg@900w_1l_2o_100sh.jpg",
  8.         "scroll_order": 0,
  9.         "scroll_jump": "http://baidu.com"
  10.     },
  11.     "code": 0
  12. }

编辑轮播图

PUT /web/scroll/{scroll_id}

  1. {
  2.     "Authorization" : {admin_token}
  3. }
  1. {
  2.     "scroll_picture": "http://img.zcool.cn/community/018d4e554967920000019ae9df1533.jpg@900w_1l_2o_100sh.jpg",
  3.     "scroll_order": 1,
  4.     "scroll_jump": "http://baidu.com"
  5. }
参数 类型 必须 说明
scroll_picture 字符串 否 FAQ类型
scroll_order 字符串 否 FAQ标题
scroll_jump 字符串 否 FAQ描述 
  1. {
  2.     "message": {
  3.         "scroll_id": 2,
  4.         "app_id": "3758749b-4a05-492f-b737-08d0c142e3dc",
  5.         "created_at": "2018-01-22T11:07:24.834000",
  6.         "updated_at": "2018-01-22T11:31:59.757000",
  7.         "scroll_picture": "http://img.zcool.cn/community/018d4e554967920000019ae9df1533.jpg@900w_1l_2o_100sh.jpg",
  8.         "scroll_order": 1,
  9.         "scroll_jump": "http://baidu.com"
  10.     },
  11.     "code": 0
  12. }

删除轮播图

DELETE /web/scroll/{scroll_id}

  1. {
  2.     "Authorization" : {admin_token}
  3. }
参数 类型 必须 说明
scroll_id 整型 是 主键 scroll_id 
  1. {
  2.     "message": "success",
  3.     "code": 0
  4. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注