美文网首页
三项修习管理端

三项修习管理端

作者: 宝宝爱樱花 | 来源:发表于2018-09-06 01:23 被阅读0次

接口约定

  • 使用https
  • restful风格
  • 用户端：https://{域名}/api/{接口版本号}/{resource}/{resource_id}/{sub_resource}/{sub_resource_id}/{action}?{query_string}
  • 管理端：https://{域名}/admin/api/{接口版本号}/{resource}/{resource_id}/{sub_resource}/{sub_resource_id}/{action}?{query_string}
  • 测试环境域名babieta.xivan.cn
  • 正式环境域名待定
  • 公共参数放在header，如userid,session_key,unionid,version等

gcid算法

def gcid_hash_file(path):
    h = hashlib.sha1()
    size = os.path.getsize(path)
    psize = 0x40000
    while size / psize > 0x200 and psize < 0x200000:
        psize = psize << 1
    with open(path, 'rb') as stream:
        data = stream.read(psize)
        while data:
            h.update(hashlib.sha1(data).digest())
            data = stream.read(psize)
    return h.hexdigest()

GET /auth/qiniu/tokens/<gcid>

name cname type Description
用途 获取七牛token
版本号 v1.0
gcid gcid

例

curl -XGET https://babieta.xivan.cn/api/v1.0/auth/qiniu/tokens/abc
返回数据：
name cname type Description
code int 返回码 0成功 非0失败
msg string 错误信息
token string 上传文件凭证(5分钟有效)
key string 上传文件key

例

{
    "code"0,
    "msg":"",
    "token":"xxxx",
    "key":"yyyy"
}

POST /studies/{studies_id}/contents/{contents_id}/

name cname type Description
用途 获取修习列表
版本号 v1.0
studies_id express(表达训练)/soak(浸泡训练)/communication(交流训练)
contents_id 题目id
请求数据：

query_string 参数/可选参数 (get)

name cname type Description
limit 数目 int 默认10
offset 偏移量 int 默认0
filter 筛选条件 object 可选

filter

name cname type Description
status 状态 int 1 上架 2下架
level 等级 array<int> 适用级别

例

curl -XGET -i "https://babieta.xivan.cn/admin/api/v1.0/studies/express?offset=0&limit=4&filter={"status":1, "level":[1,2]}"
返回数据：
name cname type Description
code int 返回码 0成功 非0失败
msg string 错误信息
list array<object> 测试题列表
count int 总数

object->express_info(表达训练)

name cname type Description
id int id
title string 标题
cover_url int 单词图片
word_chi string 单词中文
audio_text string 语音文本
audio_url string 语音播放url
level 等级 array<int> 适用级别

object->soak_info(浸泡训练)

name cname type Description
id int id
title string 标题
cover_url int 语音图片
audio_url string 语音播放url
level array<int> 适用等级

object->communication_info(交流训练)

name cname type Description
id int id
title string 标题
audio_text string 语音文本
audio_url string 语音播放url
level array<int> 适用等级

例

{"msg": "", "code": 0, "count":10, "list": [{"id":1, "title":"xxx","audio_text":"xxx", "audio_url":"xxx", "level":[1,2,3,4],...}]}

GET /studies/{studies_id}/contents/{contents_id}

name cname type Description
用途 获取修习项信息
版本号 v1.0
studies_id express(表达训练)/soak(浸泡训练)/communication(交流训练)
contents_id 题目id
请求数据：

query_string 参数/可选参数 (get)

name cname type Description

例

curl -XGET -i "https://babieta.xivan.cn/admin/api/v1.0/studies/express/1"
返回数据：
name cname type Description
code int 返回码 0成功 非0失败
msg string 错误信息
info object 测试题列表

object->express_info(表达训练)

name cname type Description
id int id
title string 标题
cover_url int 单词图片
word_chi string 单词中文
audio_text string 语音文本
audio_url string 语音播放url
level array<int> 适用等级

object->soak_info(浸泡训练)

name cname type Description
id int id
title string 标题
cover_url int 语音图片
audio_url string 语音播放url
level array<int> 适用等级

object->communication_info(交流训练)

name cname type Description
id int id
title string 标题
audio_text string 语音文本
audio_url string 语音播放url
level array<int> 适用等级

例

{"msg": "", "code": 0, "list": [{"id":1, "title":"xxx", "audio_text":"xxx", "audio_url":"ccc", "level":[1,2,3]}]}

POST /studies/{studies_id}/contents

name cname type Description
用途 添加修习内容
版本号 v1.0
studies_id express(表达训练)/soak(浸泡训练)/communication(交流训练)
请求数据：

body 参数

express_info(表达训练)

name cname type Description
title string 标题
cover_gcid int 单词gcid
word_chi string 单词中文
audio_text string 语音文本
audio_gcid string 语音播放gcid

soak_info(浸泡训练)

name cname type Description
title string 标题
cover_gcid int 图片gcid
audio_gcid string 语音gcid

communication_info(交流训练)

name cname type Description
title string 标题
audio_text string 语音文本
audio_gcid string 语音文件gcid

例

curl -XPOST -i "https://babieta.xivan.cn/admin/api/v1.0/studies/express" -H "Content-Type/application/json" 
-d '{"title":"xxx", "cover_gcid":"yyy", "word_chi":"333", "audio_text":"333", "audio_gcid":"xxx"}'
返回数据：
name cname type Description
code int 返回码 0成功 非0失败
msg string 错误信息

例

{"msg": "", "code": 0}

PUT /studies/{studies_id}/contents/{contents_id}

name cname type Description
用途 编辑修习内容(局部更新)
版本号 v1.0
studies_id express(表达训练)/soak(浸泡训练)/communication(交流训练)
contents_id 内容项id
请求数据：

body 参数/除id外均可选参数

express_info(表达训练)

name cname type Description
id int id
title string 标题
cover_url int 单词图片
word_chi string 单词中文
audio_text string 语音文本
audio_gcid string 语音文件gcid

soak_info(浸泡训练)

name cname type Description
id int id
title string 标题
cover_url int 语音图片
audio_gcid string 语音文件gcid

communication_info(交流训练)

name cname type Description
id int id
title string 标题
audio_text string 语音文本
audio_gcid string 语音文件gcid

例

curl -XPUT -i "https://babieta.xivan.cn/admin/api/v1.0/studies/express/contents/2" -H "Content-Type/application/json" 
-d '{"title":"xxx", "cover_url":"yyy", "word_chi":"333", "audio_text":"333", "audio_gcid":"xxx"}'
返回数据：
name cname type Description
code int 返回码 0成功 非0失败
msg string 错误信息

例

{"msg": "", "code": 0}

DELETE /studies/{studies_id}/contents/{contents_id}

name cname type Description
用途 删除修习内容项
版本号 v1.0
studies_id express(表达训练)/soak(浸泡训练)/communication(交流训练)
contents_id 内容项id

例

curl -XDELETE -i "https://babieta.xivan.cn/admin/api/v1.0/studies/express/contents/2" -H "Content-Type/application/json"
返回数据：
name cname type Description
code int 返回码 0成功 非0失败
msg string 错误信息

例

{"msg": "", "code": 0}

相关文章

  • 接口索引

    首测接口协议 (废弃) 登录 用户信息 测验接口协议(首测、升级解锁) 三项修习 积分 三项修习管理端 评论 点...

  • 三项修习管理端

    接口约定 使用httpsrestful风格用户端：https://{域名}/api/{接口版本号}/{resour...

  • 三项修习

    接口约定 使用httpsrestful风格用户端：https://{域名}/api/{接口版本号}/{resour...

  • 成功人士333法则

    三项管理：1、优势管理2、学习管理3、财商管理。 三项核心能力：1、演说2、写作3、营销 三大策略：1、顺势2、借...

  • 24.SSH免密登录-分发公钥脚本

    01.管理端创建秘钥对信息02.管理端需要将公钥进行分发 注意：1.管理端的“id_rsa.pub”文件与被管理端...

  • 内推项目总结

    负责部分： 一期：企业端的首页、个人中心、企业管理、报表中心，管理端的所有模块 二期：企业端的人才库管理和管理端人...

  • bar

    管理端 酒吧管理 菜单管理 类别管理

  • 电商功能

    PC端前台 移动端 管理后台

  • 2019下半年工作总结

    一、管理方面 首先，管理半径的扩大，实现了集团设计管理的统一。人员，B端和C端设计同时管理。B端改变了设计团队。设...

  • 你可能真的不会开会

    我学陈春花《数字化时代的管理进阶课》 管理技能之开会 做好管理的三项基础 1、管理理论 2、管理工具与方法 3、管...

网友评论

      本文标题：三项修习管理端

      本文链接：https://www.haomeiwen.com/subject/keftgftx.html

      延伸阅读

      深度阅读

      • 您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

      栏目导航

      热点阅读

      关于我们|服务条款|联系我们|三项修习管理端|投稿指南|网站地图|RSS订阅|排版工具|手机版

      提供经典美文摘抄,优美散文欣赏,现代诗歌精选,短篇小说,心情随笔,表白情书范文,故事会在线阅读欣赏

      Copyright © 2014-2023 Haomeiwen.com All Rights Reserved. 好美文阅读网 版权所有

      备案信息：桂公网安备 45052102000051号 · 桂ICP备13007215号-3

      本站所收录作品、热点评论等信息部分来源互联网，目的只是为了系统归纳学习和传递资讯

      所有作品版权归原创作者所有，与本站立场无关，如不慎侵犯了你的权益，请联系我们告知，我们将做删除处理！