（节目平台）VPaas平台PHP API接口文档

VPaas组件化 媒资平台

更新历史

目录

1. 对接方式、鉴权认证

凡是要使用应用能力的接口，双方需通过对比加密sign值，进行安全校验，否则接口不能使用。

加密算法：
sign = md5(shal(appid + time + random) + key);

成功样例
http://media.sewise.com/v1/media/info?appid=ic89rf8705ztf6uip7&time=1481600689&sign=818b8ca06a1dc4811d25983d6b19bfc3&random=123456

2. 全局返回码说明

每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。

HTTP请求状态返回格式

错误样例
{
"status": 40013,
"message": {"0":"invalid appid"}
}
成功样例
{
"status": 200,
"data": {"access_token":"ACCESS_TOKEN","expires_in":7200}
}

1.节目分类

1.1 查询节目分类列表

接口地址

/v1/program/category

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://program.sewise.com/v1/program/category
Response
{
"status": 200,
"data": [{"cId":"4","name":"视频4","level":"3","parentId":"2"},{"cId":"6","name":"目录2","parentId":"0","level":"1","children":[{"cId":"7","name":"视频","level":"2","parentId":"1"}]}]
}

1.2 删除节目分类列表

接口地址

/v1/program/delCategory

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
cId	是	Int	分类Id；删除父节点时，前端应该提示：确定删除该分类和其分类下的子分类？用户确定后才提交请求

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d {"cId":"2"}
http://porgram.sewise.com/v1/program/delCategory
Response
{
"status": 200,
"message": "删除成功",
}

1.3 编辑节目分类列表

接口地址

/v1/program/editCategory

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
cId	是	Int	分类Id
name	是	String	目录名称

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d {"cId":"2"，"name":"视频","parentId":"1"} http://porgram.sewise.com/v1/porgram/editCategory
Response
{
"status": 200,
"message": "修改成功",
"data": {
"cId": "2",
"name": "视频",
"parentId": "1",
"userId": "1",
"aId": "1",
"modifiedDate": "2016-12-14 11:06:24",
"status": "1"
}
}

1.4 创建一个目录节点

接口地址

/v1/media/createCategory

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
name	是	String	目录名称
parentId	否	Int	父节点id

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d {"name":"默认目录","parentId":"12"} http://porgram.sewise.com/v1/porgram/createCategory
Response
{
"status": 200,
"data": {
"cId": "3",
"name": "视频录像",
"parentId": "1",
"userId": "1",
"aId": "1",
"status":1
}
}

2.节目平台

2.1 查询节目列表

接口地址

/v1/program/list

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
cId	否	Int	分类点id

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://program.sewise.com/v1/program/list
Response
{
"status": 200,
"data": []
}

2.2 查询节目列表

接口地址

/v1/program/delete

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
programIds	是	Int	媒资Id组成的数组转的字符串（如 "1,2,3"）

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://program.sewise.com/v1/program/delete
Response
{
"status": 200,
"message": "删除成功",
}

2.3 查询节目列表

接口地址

/v1/program/search

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
programId	是	Int	节目Id）

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://program.sewise.com/v1/program/delete
Response
{
"status": 200,
"message": "删除成功",
}