移动端上传支持使用说明

1 功能简介

网易云视频官网API适用于业务服务器调用,为满足业务服务器的终端用户上传视频以及点播加密等需求。设计相关API如下。

2 功能逻辑

3 API

注:以下API的调用方式和请求头参数均和官网一致。

3.1 创建终端用户

3.1.1 接口描述

域名:vcloud.163.com

接口名:/app/vod/thirdpart/user/create

用于业务服务器向网易云视频注册其终端用户信息。

3.1.2 输入参数

参数 类型 必须 说明
accid String 网易云视频用户创建的其子用户id,最大长度32字符,必须保证唯一
name String 网易云视频用户创建的其子用户名称
type int 网易云视频用户创建其子用户的方式,1表示由网易云视频生成token,
2表示由网易云视频用户传入token
props String json属性,第三方可选填,最大长度256字符
token String 网易云视频用户可以指定其子用户登录token值,最大长度128字符,
并更新,如果未指定,会自动生成token,
并在创建成功后返回,如果type = 2,则必填

3.1.3 输出参数

参数 类型 说明
code Int 响应码
accid String 网易云视频用户创建的其子用户id
name String 网易云视频用户创建的其子用户名称
token String 网易云视频用户子用户的token
props String json属性,第三方可选填,最大长度256字符
msg String 错误信息

3.1.4 响应状态码

HTTP状态码 含义
200 操作成功
400 请求报文格式错误,报文构造不正确或者没有完整发送
700 服务器内部出现错误,请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710 权限认证失败,请参考文档中的接口鉴权部分
720 访问失败,余额不足。
721 服务未开通,请前往开通页面申请服务开通
722 服务开通审核中,请联系客服人员开通服务
723 请求的次数超过了配额限制

3.1.5 示例代码

输入1
curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d '{"accid":"227","name":"网易云视频","type":1,"props":"test"}' https://vcloud.163.com/app/vod/thirdpart/user/create
输出1
"Content-Type": "application/json; charset=utf-8"
{
  "ret": {      
    "accid":"227",
    "name":"网易云视频",
    "token": "ioapfhoapdfjoahfdaoyfdvmafijuopa",
    "props":"test",     
  },
  "code": 200
}

3.2 更新终端用户

3.2.1 接口描述

域名:vcloud.163.com

接口名:/app/vod/thirdpart/user/update

用于业务服务器向网易云视频更新其终端用户信息。

3.2.2 输入参数

参数 类型 必须 说明
accid String 网易云视频用户其子用户id,最大长度32字符,必须保证唯一
name String 网易云视频用户其子用户名称
props String json属性,第三方可选填,最大长度256字符
token String 网易云视频用户可以指定其子用户登录token值,最大长度128字符

3.2.3 输出参数

参数 类型 说明
code Int 响应码
accid String 网易云视频用户创建的其子用户id
name String 网易云视频用户创建的其子用户名称
token String 网易云视频用户子用户的token
props String json属性,第三方可选填,最大长度256字符
isUsed Int 该子用户是否被禁用,0表示未被禁用,1表示被禁用
msg String 错误信息

3.2.4 响应状态码

HTTP状态码 含义
200 操作成功
400 请求报文格式错误,报文构造不正确或者没有完整发送
700 服务器内部出现错误,请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710 权限认证失败,请参考文档中的接口鉴权部分
720 访问失败,余额不足。
721 服务未开通,请前往开通页面申请服务开通
722 服务开通审核中,请联系客服人员开通服务
723 请求的次数超过了配额限制

3.2.5 示例代码

输入1
curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d '{"accid":227, "name":"娱乐"}' https://vcloud.163.com/app/vod/thirdpart/user/update
输出1
"Content-Type": "application/json; charset=utf-8"
{
  "ret": {
    "token": "ioapfhoapdfjoahfdaoyfdvmafijuopa",
    "accid":"227",
    "name":"娱乐",
    "props":"test", 
    "isUsed":1,    
  },
  "code": 200
}

3.3 删除终端用户

3.3.1 接口描述

域名:vcloud.163.com

接口名:/app/vod/thirdpart/user/userDelete

用于业务服务器向网易云视频删除其终端用户信息。

3.3.2 输入参数

参数 类型 必须 说明
accid String 网易云视频用户其子用户id,最大长度32字符,必须保证唯一

3.3.3 输出参数

参数 类型 说明
code Int 响应码
msg String 错误信息

3.3.4 响应状态码

HTTP状态码 含义
200 操作成功
400 请求报文格式错误,报文构造不正确或者没有完整发送
700 服务器内部出现错误,请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710 权限认证失败,请参考文档中的接口鉴权部分
720 访问失败,余额不足。
721 服务未开通,请前往开通页面申请服务开通
722 服务开通审核中,请联系客服人员开通服务
723 请求的次数超过了配额限制

3.3.5 示例代码

输入1
curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d '{"accid":227}' https://vcloud.163.com/app/vod/thirdpart/user/userDelete
输出1
"Content-Type": "application/json; charset=utf-8"
{
  "ret": {},
  "code": 200
}

3.4 屏蔽终端用户

3.4.1 接口描述

域名:vcloud.163.com

接口名:/app/vod/thirdpart/user/userDisable

用于业务服务器向网易云视频屏蔽其终端用户信息。

3.4.2 输入参数

参数 类型 必须 说明
accid String 网易云视频用户其子用户id,最大长度32字符,必须保证唯一

3.4.3 输出参数

参数 类型 说明
code Int 响应码
msg String 错误信息

3.4.4 响应状态码

HTTP状态码 含义
200 操作成功
400 请求报文格式错误,报文构造不正确或者没有完整发送
700 服务器内部出现错误,请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710 权限认证失败,请参考文档中的接口鉴权部分
720 访问失败,余额不足。
721 服务未开通,请前往开通页面申请服务开通
722 服务开通审核中,请联系客服人员开通服务
723 请求的次数超过了配额限制

3.4.5 示例代码

输入1
curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d '{"accid":227}' https://vcloud.163.com/app/vod/thirdpart/user/userDisable
输出1
"Content-Type": "application/json; charset=utf-8"
{
  "ret": {},
  "code": 200
}

3.5 恢复终端用户

3.5.1 接口描述

域名:vcloud.163.com

接口名:/app/vod/thirdpart/user/userRecover

用于业务服务器向网易云视频恢复其终端用户信息。

3.5.2 输入参数

参数 类型 必须 说明
accid String 网易云视频用户其子用户id,最大长度32字符,必须保证唯一

3.5.3 输出参数

参数 类型 说明
code Int 响应码
msg String 错误信息

3.5.4 响应状态码

HTTP状态码 含义
200 操作成功
400 请求报文格式错误,报文构造不正确或者没有完整发送
700 服务器内部出现错误,请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710 权限认证失败,请参考文档中的接口鉴权部分
720 访问失败,余额不足。
721 服务未开通,请前往开通页面申请服务开通
722 服务开通审核中,请联系客服人员开通服务
723 请求的次数超过了配额限制

3.5.5 示例代码

输入1
curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d '{"accid":227}' https://vcloud.163.com/app/vod/thirdpart/user/userRecover
输出1
"Content-Type": "application/json; charset=utf-8"
{
  "ret": {},
  "code": 200
}

目前网易云视频支持使用 Accid 和 Token 和 AppKey 值作为 API 的请求头,替代 Nonce、CheckSum、CurTime、AppKey。