文档中心 > 入门指南

视频数据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_id=获取的学段ID&nianji_id=获取的年级ID&xueke_id=获取的学科ID&leixing_id=获取的类型ID&banben_id=获取的版本ID&ce_id=获取的册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_id=获取的学段ID&nianji_id=获取的年级ID&xueke_id=获取的学科ID&leixing_id=获取的类型ID&banben_id=获取的版本ID&ce_id=获取的册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_id=获取的学段ID&nianji_id=获取的年级ID&xueke_id=获取的学科ID&leixing_id=获取的类型ID&banben_id=获取的版本ID&ce_id=获取的册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_id=获取的学段ID&nianji_id=获取的年级ID&xueke_id=获取的学科ID&leixing_id=获取的类型ID&banben_id=获取的版本ID&ce_id=获取的册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_id=获取的学段ID&nianji_id=获取的年级ID&xueke_id=获取的学科ID&leixing_id=获取的类型ID&banben_id=获取的版本ID&ce_id=获取的册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. 技术支持

接口开发技术支持QQ群:114918270