视频数据API接口
一、概述
获取全品学堂视频说明
二、如何使用
应用创建后，会自动生成appid,appkey，然后将所需参数拼装成http请求，即可调用。支持php,java等。
三、接口说明
1. 接口描述
url
https://open.canpoint.net/openapi/basedata/get_video
功能描述
获取视频课程接口
返回格式
Json，utf8
HTTP请求方式
get
2. 请求描述
2.1 请求参数(header)
参数名
类型
必填
参数位置
描述
默认值
appid
string
是
header
应用ID
无
appkey
string
是
header
应用密钥
无
2.2 输入参数(urlParam)
参数名
类型
必填
参数位置
描述
默认值
xueduan_attrid
string
是
urlParam
学段属性ID
无
nianji_attrid
string
是
urlParam
年级属性ID
无
xueke_attrid
string
是
urlParam
学科属性ID
无
leixing_attrid
string
是
urlParam
类型属性ID
无
banben_attrid
string
是
urlParam
版本属性ID
无
ce_attrid
string
是
urlParam
册属性ID
无
danyuan_attrid
string
是
urlParam
单元属性ID
无
2.3 输出参数
参数名
类型
必填
描述
默认值
result
int
是
返回信息
0
count
int
是
返回总数
0
msg
string
是
返回描述
空
data
array()
是
返回值
空
data['id']
srting
是
视频ID
空
data['ke_title']
string
是
视频标题
空
data['ke_content']
string
是
视频内容
空
data['ke_image']
string
是
视频图片
空
data['ke_teacher_url']
string
是
视频老师链接
空
data['ke_teacher']
string
是
视频老师
空
data['ke_video_url']
string
是
视频链接
空
3.请求示例
3.1 请求示例
3.1.1 curl示例
curl --get --include 'https://open.canpoint.net/openapi/basedata/get_video?xueduan_attrid=获取的学段ID&nianji_attrid=获取的年级ID&xueke_attrid=获取的学科ID&leixing_attrid=获取的类型ID&banben_attrid=获取的版本ID&ce_attrid=获取的册ID&danyuan_attrid=获取的单元ID -H 'appid:您自己的appid \n appkey:您自己的appkey'3.1.2 php示例
<?php
$ch = curl_init();
$url = 'https://open.canpoint.net/openapi/basedata/get_video?xueduan_attrid=获取的学段ID&nianji_attrid=获取的年级ID&xueke_attrid=获取的学科ID&leixing_attrid=获取的类型ID&banben_attrid=获取的版本ID&ce_attrid=获取的册ID&danyuan_attrid=获取的单元ID';
$header = array(
'appid':您自己的appid',
'appkey: 您自己的appkey'
);
// 添加apikey到header
curl_setopt($ch, CURLOPT_HTTPHEADER , $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// 执行HTTP请求
curl_setopt($ch , CURLOPT_URL , $url);
$res = curl_exec($ch);
var_dump(json_decode($res));
?>3.1.3 python示例
# -*- coding: utf-8 -*-
import sys, urllib, urllib2, json
url = 'https://open.canpoint.net/openapi/basedata/get_video?xueduan_attrid=获取的学段ID&nianji_attrid=获取的年级ID&xueke_attrid=获取的学科ID&leixing_attrid=获取的类型ID&banben_attrid=获取的版本ID&ce_attrid=获取的册ID&danyuan_attrid=获取的单元ID';
req = urllib2.Request(url)
req.add_header("appid", "您自己的appid")
req.add_header("appkey", "您自己的appkey")
resp = urllib2.urlopen(req)
content = resp.read()
if(content):
print(content)3.1.4 java示例
String httpUrl = "https://open.canpoint.net/openapi/basedata/get_video";
String httpArg = "?xueduan_attrid=获取的学段ID&nianji_attrid=获取的年级ID&xueke_attrid=获取的学科ID&leixing_attrid=获取的类型ID&banben_attrid=获取的版本ID&ce_attrid=获取的册ID&danyuan_attrid=获取的单元ID";
String jsonResult = request(httpUrl, httpArg);
System.out.println(jsonResult);
/**
* @param urlAll
* :请求接口
* @param httpArg
* :参数
* @return 返回结果
*/
public static String request(String httpUrl, String httpArg) {
BufferedReader reader = null;
String result = null;
StringBuffer sbf = new StringBuffer();
httpUrl = httpUrl + "?" + httpArg;
try {
URL url = new URL(httpUrl);
HttpURLConnection connection = (HttpURLConnection) url
.openConnection();
connection.setRequestMethod("GET");
// 填入apikey到HTTP header
connection.setRequestProperty("appid", "您自己的appid");
connection.setRequestProperty("appkey", "您自己的appkey");
connection.connect();
InputStream is = connection.getInputStream();
reader = new BufferedReader(new InputStreamReader(is, "UTF-8"));
String strRead = null;
while ((strRead = reader.readLine()) != null) {
sbf.append(strRead);
sbf.append("rn");
}
reader.close();
result = sbf.toString();
} catch (Exception e) {
e.printStackTrace();
}
return result;
}3.1.5 C#示例
string url = "https://open.canpoint.net/openapi/basedata/get_video";
string param = "?xueduan_attrid=获取的学段ID&nianji_attrid=获取的年级ID&xueke_attrid=获取的学科ID&leixing_attrid=获取的类型ID&banben_attrid=获取的版本ID&ce_attrid=获取的册ID&danyuan_attrid=获取的单元ID";
string result = request(url,param);
/// /// 发送HTTP请求
///
/// 请求的URL
/// 请求的参数
/// 请求结果
public static string request(string url, string param)
{
string strURL = url + '?' + param;
System.Net.HttpWebRequest request;
request = (System.Net.HttpWebRequest)WebRequest.Create(strURL);
request.Method = "GET";
// 添加header
request.Headers.Add("appid", "您自己的appid");
request.Headers.Add("appkey", "您自己的appkey");
System.Net.HttpWebResponse response;
response = (System.Net.HttpWebResponse)request.GetResponse();
System.IO.Stream s;
s = response.GetResponseStream();
string StrDate = "";
string strValue = "";
StreamReader Reader = new StreamReader(s, Encoding.UTF8);
while ((StrDate = Reader.ReadLine()) != null)
{
strValue += StrDate + "rn";
}
return strValue;
}3.2 返回值
{
"result": 0,
"count": 1,
"msg": "",
"data": [
{
"id": "6s5D25wtTnAuq64TZ6cyhA==",
"ke_title": "非负数“生日派对”",
"ke_content": "本课是以拟人化的手法，通过两个例题和一个练习的讲解，讲述了三种形式非负数的性质，本知识点是中考二次根式章节中的重点和难点",
"ke_image": "https://img1.canpoint.net/g1/M00/04/D6/oYYBAFUKKoqAFO0NAABrmvmlpxA257.jpg",
"ke_teacher_url": "https://ms.canpoint.net/teacher/t/6s5D25wtTnDiMz4PyF9j6A==.html",
"ke_teacher": "quanpin",
"ke_video_url": "https://wk.canpoint.net/video/v/6s5D25wtTnBVRveyoutgpQ==.html"
}
]
}4. 错误参照码
错误码
错误码返回说明
0
成功返回
1010
应用appid错误
1012
商户id错误
1013
TOKEN超时
1014
TOKEN失效
1015
该视频不在应用服务内
1016
TOKEN不存在
1017
token对应视频id错误
1018
来源地址错误
2010
来源地址错误
2011
点播失败
2013
参数不正确
2015
应用appid或key值错误
5. 技术支持
