README

### 深圳二一教育开放平台接口说明

二一教育开放平台是指将二一数十年积累的优质教育资源开放给广大开发者。开发者通过我们的开放接口获取到海量的K12教育资源以完善自己的教育产品建设，从而达到合作、共赢。

内容上，教育资源开放平台涵盖客户亟需的试题库、备课资料库等教育资源，其容量之大、种类之多、质量之高、更新之快、体系精细、独家授权的优势得天独厚。客户可通过系统对接等简易灵活的方式在教育资源开放平台上与二一实现数据级合作，各取所需，实现共赢。

功能上，教育资源开放平台可根据客户的需要，利用平台中成熟完备的备课、组卷及在线学习模块将丰富的资源内容更高效地进行系统集成，完善客户产品。

SDK 调用示例

<?php

// 本示例以及 SDK 运行环境 必须 >= php 5.3

// sdk 示例
// 引入SDK 源码文件所在目录的 Autoloader.php
require __DIR__ . '/src/Autoloader.php';

$client = \sdk\Client::getInstance(array(
    'accessKey' => '',
    'accessSecret' => '',
    'baseUrl' => 'http://dev.21cnjy.com'
));


/**
 * 调用公共模块接口
 * commonService 具体可以调用的接口方法
 * 请查看 /21cnjySDK/src/modules/Common
 */
$service = $client->getCommonService();
// 得到指定学段下科目信息 学段ID, 1:小学，2:初中，3:高中
$result = $service->getSubjects(1);
// 得到指定学段学科下教材版本信息
$result = $service->getVersions(2, 2);
// 得到指定教材版本下册别(册别泛指：一年级上册、一年假下册)
$result = $service->getBooks(10423);
// 得到指定册别下书本章节信息
$result = $service->getChapters(534);
// 得到指定学段学科下的知识点
$result = $service->getKnowledge(1, 2);

/**
 * 调用文档资源模块接口
 * 具体可以调用的接口方法 请查看类文件： /21cnjySDK/src/modules/Document.php
 */
$service = $client->getDocumentService();
// 获取文档资源列表
$result = $service->getItems();
// 获取指定文档资源的下载地址
$result = $service->getDownloadUrl('509564,507093,503183');
// 获取多个文档资源详情
$result = $service->getItemDetails('3666625,3666624');


/**
 * 调用题库资源模块接口
 * 具体可以调用的接口方法 请查看类文件： /21cnjySDK/src/modules/Question.php
 */
$service = $client->getQuestionService();
// 获取指定学段学科下的试题类型列表
$result = $service->getTypeList(2, 2);
// 获取单个试题的答案和解析
$result = $service->getAnswer(4);
// 获取多个试题的答案和解析
$result = $service->getAnswers('4,5,6');
// 获取多个试题详细信息
$result = $service->getDetails('4,6,6');
// 通过教材章节获取试题列表
$result = $service->getListByChapterId(5729);
// 通过知识点获取试题列表
$result = $service->getListByKnowledge(13530);


/**
 * 调用视频资源模块接口
 * 具体可以调用的接口方法 请查看类文件： /21cnjySDK/src/modules/Video.php
 */
$service = $client->getVideoService();

// 获取视频资源列表接口
$result = $service->getVideoList();
// 通过视频ID得到视频下载(播放)地址
$result = $service->getDownloadUrl(24093);

接口详细说明文档请访问

sqy / 21cnjy

Maintainers

Details

README

http://dev.21cnjy.com/docs/