@sewise-dev
2016-12-19T06:36:55.000000Z
字数 3853
阅读 813
VPaas组件化
快电影
编号 | 版本 | 说明 | 作者 | 日期 |
---|---|---|---|---|
1 | v1.0 | 1.创建文档 | cjr | 2016-12-16 |
凡是要使用应用能力的接口,双方需通过对比加密sign值,进行安全校验,否则接口不能使用。
加密算法:
sign = md5(shal(appid + time + random) + key);
每次调用接口时,可能获得正确或错误的返回码,开发者可以根据返回码信息调试接口,排查错误。
返回码 | 说明 |
---|---|
-1 | 系统繁忙,此时请开发者稍候再试 |
200 | 请求成功 |
403 | 禁止访问 |
404 | 异常错误 |
500 | 数据验证错误 |
40001 | 不合法的凭证,或者access_token无效。 |
40004 | 不合法请求 |
HTTP请求状态返回格式
返回字段 | 字段类型 | 说明 |
---|---|---|
status | Integer | 请求返回码(详细请见状态表) |
message | String | 返回描述 |
data | Array | 返回结果 |
错误样例
{
"status": 40013,
"message": {"0":"invalid appid"}
}
成功样例
{
"status": 200,
"data": {"access_token":"ACCESS_TOKEN","expires_in":7200}
}
/v1/movie/createProgram
application/json
POST
参数 必选 类型 说明 RequestBody org_id 是 string 机构id title 是 string 节目标题 poster 是 string 节目海报 cover 是 string 节目海报(横版) description 是 string 简介 prevue 是 string (媒资id组成的数组转换为json) expect_time 是 string 预计时间 voddata 是 string (媒资id组成的数组转换为json)
200
返回字段 | 字段类型 | 说明 |
---|---|---|
status | int | 返回状态码 |
message | String | 返回错误信息 |
data | Array | 返回结果 |
Request
curl -X POST -H "Content-Type:application/json" -d {"org_id":"1",
"title":"aaaa","poster":"","cover":"","description":"","prevue":"","expect_time":"",
"voddata":""}
http://movie.seiwse.com/v1/movie/createNode
Response
{
"status": 200,
"data": {
"programid": "3",
}
}
/v1/movie/editProgram
application/json
POST
参数 必选 类型 说明 RequestBody programid 是 string 节目id org_id 是 string 机构id title 是 string 节目标题 poster 是 string 节目海报 cover 是 string 节目海报(横版) description 是 string 简介 prevue 是 string (媒资id组成的数组转换为json) expect_time 是 string 预计时间 voddata 是 string (媒资id组成的数组转换为json)
200
返回字段 | 字段类型 | 说明 |
---|---|---|
status | int | 返回状态码 |
message | String | 返回错误信息 |
data | Array | 返回结果 |
Request
curl -X POST -H "Content-Type:application/json" -d {"programid":"2","org_id":"1",
"title":"aaaa","poster":"","cover":"","description":"","prevue":"","expect_time":"","voddata":""} http://movie.seiwse.com/v1/movie/editProgram
Response
{
"status": 200,
"message": "修改成功"
}
/v1/movie/deleteProgram
application/json
POST
参数 必选 类型 说明 RequestBody programid 是 string (节目id组成的数组转换为json)
200
返回字段 | 字段类型 | 说明 |
---|---|---|
status | int | 返回状态码 |
message | String | 返回错误信息 |
data | Array | 返回结果 |
Request
curl -X POST -H "Content-Type:application/json" -d {"programid":"2"}
http://movie.seiwse.com/v1/movie/deleteProgram
Response
{
"status": 200,
"message": "删除成功",
}
/v1/movie/getCount
application/json
POST
参数 必选 类型 说明 RequestBody org_id 是 int 机构id,默认为0,返回所有
200
返回字段 | 字段类型 | 说明 |
---|---|---|
status | int | 返回状态码 |
message | String | 返回错误信息 |
data | Array | 返回结果 |
Request
curl -X POST -H "Content-Type:application/json" -d {"org_id":"0"}
http://movie.seiwse.com/v1/movie/getCount
Response
{
"status": 200,
"data": "{统计数据}",
}
/v1/movie/info
application/json
POST
参数 必选 类型 说明 RequestBody programid 是 string 节目id
200
返回字段 | 字段类型 | 说明 |
---|---|---|
status | int | 返回状态码 |
message | String | 返回错误信息 |
data | Array | 返回结果 |
Request
curl -X POST -H "Content-Type:application/json" -d {"programid":"1"}
http://movie.seiwse.com/v1/movie/info
Response
{"status":200,"data":{节目信息}}
/v1/movie/list
application/json
GET/POST
参数 必选 类型 说明 RequestBody catalog 否 int 分类ID,默认所有分类 keyword 否 String 关键词,默认所有 selectstatus 否 int 过滤的状态,默认所有 page 否 int 页数,默认1 pageSize 否 int 页码,默认20 order 否 String 排序,默认倒序
200
返回字段 | 字段类型 | 说明 |
---|---|---|
status | int | 返回状态码 |
message | String | 返回错误信息 |
data | Array | 返回结果 |
Request
curl -X POST -H "Content-Type:application/json" -d {"catalog":"","page":"1","pageSize":"20","order":"programid Desc","keyword":"aaa","selectstatus":0}
http://movie.seiwse.com/v1/movie/list
Response
{"status":200,"data":{"total_page":1,"page":"1","pagesize":"20","total_record":1,"record":[{节目数据}]}}