文档中心 > 入门指南

单元数据API接口

一、概述

获取全品学堂单元说明

二、如何使用

应用创建后,会自动生成appid,appkey,然后将所需参数拼装成http请求,即可调用。支持php,java等。

三、接口说明

1. 接口描述

url https://open.canpoint.net/openapi/basedata/new_get_danyuan
功能描述 获取单元接口
返回格式 Json,utf8
HTTP请求方式 get

2. 请求描述

2.1 请求参数(header)

参数名 类型 必填 参数位置 描述 默认值
appid string header 应用ID
appkey string header 应用密钥

2.2 输入参数(urlParam)

参数名 类型 必填 参数位置 描述 默认值
xueduan_id string urlParam 学段ID
nianji_id string urlParam 年级ID
xueke_id string urlParam 学科ID
leixing_id string urlParam 类型ID
banben_id string urlParam 版本ID
ce_id string urlParam 册ID

2.3 输出参数

参数名 类型 必填 描述 默认值
result int 返回信息 0
count int 返回总数 0
msg string 返回描述
data array() 返回值
data['danyuan_name'] srting 单元名字
data['danyuan_id'] int 单元ID
data['danyuan_attrid'] int 单元属性ID

3.请求示例

3.1 请求示例

3.1.1 curl示例

curl --get --include 'https://open.canpoint.net/openapi/basedata/new_get_danyuan?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/new_get_danyuan?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/new_get_danyuan?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/new_get_danyuan";
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/new_get_danyuan";
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": 4,
"msg": "",
"data": [
{
"danyuan_name": "魔法词汇卡",
"danyuan_id": "103024",
"danyuan_attrid": "1000337"
},
{
"danyuan_name": "超级语法秀",
"danyuan_id": "103025",
"danyuan_attrid": "1001537"
},
{
"danyuan_name": "词汇大比拼",
"danyuan_id": "103026",
"danyuan_attrid": "1001534"
},
{
"danyuan_name": "写作点播台",
"danyuan_id": "103027",
"danyuan_attrid": "1000216"
}
]
}
}

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