文档中心 > API类目 > 钉钉API

dingtalk.oapi.edu.recommend.create (静态推荐数据同步)

静态推荐数据同步

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
summary	String	可选	文章摘要		摘要
thumbnail	String	必须	http://xxxx		缩略图url地址
type	String	必须	1		类型：1词汇 2课文 3题目 4考试 5知识点 6课程 7其他
title	String	必须	课文学习鲁迅文章闰土		内容标题
userid	String	必须	12344		当前用户userid
period_code	String	必须	xxxx		学段
class_id	Number	可选	123		班级ID
return_url	String	必须	/pages/index/index		回跳地址
subject_code	String	可选	xxx		学科
textbook_code	String	可选	xxx		教材版本
out_content_id	String	必须	123		ISV侧内容唯一ID
labelList	String []	可选	"人教版","语文","第一单元"	最大列表长度：100	内容标签，推荐扩散给其他用户使用
totalTime	Number	可选	10		内容总时长，单位秒

响应参数

名称	类型	示例值	描述
success	Boolean	true	返回结果成功｜失败
errcode	Number	1000	错误代码
errmsg	String	错误信息	错误信息

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/edu/recommend/create");
OapiEduRecommendCreateRequest req = new OapiEduRecommendCreateRequest();
req.setSummary("文章摘要");
req.setThumbnail("http://xxxx");
req.setType("1");
req.setTitle("课文学习鲁迅文章闰土");
req.setUserid("12344");
req.setPeriodCode("xxxx");
req.setClassId(123L);
req.setReturnUrl("/pages/index/index");
req.setSubjectCode("xxx");
req.setTextbookCode("xxx");
req.setOutContentId("123");
req.setLabelList("\"人教版\",\"语文\",\"第一单元\"");
req.setTotalTime(10L);
OapiEduRecommendCreateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/edu/recommend/create");
OapiEduRecommendCreateRequest req = new OapiEduRecommendCreateRequest();
req.Summary = "文章摘要";
req.Thumbnail = "http://xxxx";
req.Type = "1";
req.Title = "课文学习鲁迅文章闰土";
req.Userid = "12344";
req.PeriodCode = "xxxx";
req.ClassId = 123L;
req.ReturnUrl = "/pages/index/index";
req.SubjectCode = "xxx";
req.TextbookCode = "xxx";
req.OutContentId = "123";
req.LabelList = "\"人教版\",\"语文\",\"第一单元\"";
req.TotalTime = 10L;
OapiEduRecommendCreateResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiEduRecommendCreateRequest;
$req->setSummary("文章摘要");
$req->setThumbnail("http://xxxx");
$req->setType("1");
$req->setTitle("课文学习鲁迅文章闰土");
$req->setUserid("12344");
$req->setPeriodCode("xxxx");
$req->setClassId("123");
$req->setReturnUrl("/pages/index/index");
$req->setSubjectCode("xxx");
$req->setTextbookCode("xxx");
$req->setOutContentId("123");
$req->setLabelList("\"人教版\",\"语文\",\"第一单元\"");
$req->setTotalTime("10");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/edu/recommend/create");

curl -X POST "https://oapi.dingtalk.com/topapi/edu/recommend/create" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=2bc5f02c-8e1f-47bb-892e-0fb00d9d18af' \
-d 'class_id=123' \
-d 'labelList=%5C%22%E4%BA%BA%E6%95%99%E7%89%88%5C%22%2C%5C%22%E8%AF%AD%E6%96%87%5C%22%2C%5C%22%E7%AC%AC%E4%B8%80%E5%8D%95%E5%85%83%5C%22' \
-d 'out_content_id=123' \
-d 'period_code=xxxx' \
-d 'return_url=%2Fpages%2Findex%2Findex' \
-d 'subject_code=xxx' \
-d 'summary=%E6%96%87%E7%AB%A0%E6%91%98%E8%A6%81' \
-d 'textbook_code=xxx' \
-d 'thumbnail=http%3A%2F%2Fxxxx' \
-d 'title=%E8%AF%BE%E6%96%87%E5%AD%A6%E4%B9%A0%E9%B2%81%E8%BF%85%E6%96%87%E7%AB%A0%E9%97%B0%E5%9C%9F' \
-d 'totalTime=10' \
-d 'type=1' \
-d 'userid=12344'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiEduRecommendCreateRequest("https://oapi.dingtalk.com/topapi/edu/recommend/create")

req.summary="文章摘要"
req.thumbnail="http://xxxx"
req.type="1"
req.title="课文学习鲁迅文章闰土"
req.userid="12344"
req.period_code="xxxx"
req.class_id=123
req.return_url="/pages/index/index"
req.subject_code="xxx"
req.textbook_code="xxx"
req.out_content_id="123"
req.labelList=""人教版","语文","第一单元""
req.totalTime=10
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.edu.recommend.create");
add_param(pRequest,"summary","文章摘要");
add_param(pRequest,"thumbnail","http://xxxx");
add_param(pRequest,"type","1");
add_param(pRequest,"title","课文学习鲁迅文章闰土");
add_param(pRequest,"userid","12344");
add_param(pRequest,"period_code","xxxx");
add_param(pRequest,"class_id","123");
add_param(pRequest,"return_url","/pages/index/index");
add_param(pRequest,"subject_code","xxx");
add_param(pRequest,"textbook_code","xxx");
add_param(pRequest,"out_content_id","123");
add_param(pRequest,"labelList","\"人教版\",\"语文\",\"第一单元\"");
add_param(pRequest,"totalTime","10");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.edu.recommend.create', {
	'summary':'文章摘要',
	'thumbnail':'http://xxxx',
	'type':'1',
	'title':'课文学习鲁迅文章闰土',
	'userid':'12344',
	'period_code':'xxxx',
	'class_id':'123',
	'return_url':'/pages/index/index',
	'subject_code':'xxx',
	'textbook_code':'xxx',
	'out_content_id':'123',
	'labelList':'\"人教版\",\"语文\",\"第一单元\"',
	'totalTime':'10'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "success":true,
    "errcode":1000,
    "errmsg":"错误信息"
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.edu.recommend.create (静态推荐数据同步)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ