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

dingtalk.oapi.edu.homework.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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
hw_media	String	可选	url		作业视频
hw_content	String	必须	开始		作业内容
hw_title	String	必须	语文作业		作业标题
course_name	String	必须	语文		作业课程名称
hw_photo	String	可选	url		作业图片
hw_video	String	可选	url		作业录音
teacher_name	String	必须	李老师		老师名称
teacher_userid	String	必须	234234		老师userid
select_class	ClassInfoItem []	可选		最大列表长度：50	选择的布置班级
└ class_name String 可选一年级一班班级名称 └ class_id Number 可选 234234 班级ID
select_stu	SelectStuItem []	可选		最大列表长度：50	选择班级对应学生
└ class_name String 可选一年级一班班级名称 └ class_id Number 可选 234234 班级ID class_stu StuInfoItem [] 可选选择学生列表 └ stu_name String 可选王三学生姓名 └ stu_id String 可选 234234 学生userid
identifier	String	必须	234234		幂等ID字段
attributes	String	可选	234324		扩展属性
target_role	String	可选	student		发送对象
biz_code	String	必须	SONGSHU		业务编码
status	String	必须	SENDED		状态
scheduled_release	String	可选	Y		是否开始定时调度
scheduled_time	String	可选	2020-04-20 00:00:00		定时调度时间
hw_deadline_open	String	可选	Y		是否开启截止时间
hw_deadline	Number	可选	234234234234		截止时间
hw_type	String	可选	RECITE		作业类型

响应参数

名称	类型	示例值	描述
result	Number	12321323	结果
success	Boolean	true	是否成功
errcode	Number	0	错误编码
errmsg	String	demo	错误信息

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/edu/homework/create");
OapiEduHomeworkCreateRequest req = new OapiEduHomeworkCreateRequest();
req.setHwMedia("url");
req.setHwContent("开始");
req.setHwTitle("语文作业");
req.setCourseName("语文");
req.setHwPhoto("url");
req.setHwVideo("url");
req.setTeacherName("李老师");
req.setTeacherUserid("234234");
List<ClassInfoItem> list2 = new ArrayList<ClassInfoItem>();
ClassInfoItem obj3 = new ClassInfoItem();
list2.add(obj3);
obj3.setClassName("一年级一班");
obj3.setClassId(234234L);
req.setSelectClass(list2);
List<SelectStuItem> list5 = new ArrayList<SelectStuItem>();
SelectStuItem obj6 = new SelectStuItem();
list5.add(obj6);
obj6.setClassName("一年级一班");
obj6.setClassId(234234L);
List<StuInfoItem> list9 = new ArrayList<StuInfoItem>();
StuInfoItem obj10 = new StuInfoItem();
list9.add(obj10);
obj10.setStuName("王三");
obj10.setStuId("234234");
list7.setClassStu(list9);
req.setSelectStu(list5);
req.setIdentifier("234234");
req.setAttributes("234324");
req.setTargetRole("student");
req.setBizCode("SONGSHU");
req.setStatus("SENDED");
req.setScheduledRelease("Y");
req.setScheduledTime("2020-04-20 00:00:00");
req.setHwDeadlineOpen("Y");
req.setHwDeadline(234234234234L);
req.setHwType("RECITE");
OapiEduHomeworkCreateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/edu/homework/create");
OapiEduHomeworkCreateRequest req = new OapiEduHomeworkCreateRequest();
req.HwMedia = "url";
req.HwContent = "开始";
req.HwTitle = "语文作业";
req.CourseName = "语文";
req.HwPhoto = "url";
req.HwVideo = "url";
req.TeacherName = "李老师";
req.TeacherUserid = "234234";
List<OapiEduHomeworkCreateRequest.ClassInfoItemDomain> list2 = new List<OapiEduHomeworkCreateRequest.ClassInfoItemDomain>();
OapiEduHomeworkCreateRequest.ClassInfoItemDomain obj3 = new OapiEduHomeworkCreateRequest.ClassInfoItemDomain();
list2.Add(obj3);
obj3.ClassName = "一年级一班";
obj3.ClassId = 234234L;
req.SelectClass_ = list2;
List<OapiEduHomeworkCreateRequest.SelectStuItemDomain> list5 = new List<OapiEduHomeworkCreateRequest.SelectStuItemDomain>();
OapiEduHomeworkCreateRequest.SelectStuItemDomain obj6 = new OapiEduHomeworkCreateRequest.SelectStuItemDomain();
list5.Add(obj6);
obj6.ClassName = "一年级一班";
obj6.ClassId = 234234L;
List<OapiEduHomeworkCreateRequest.StuInfoItemDomain> list8 = new List<OapiEduHomeworkCreateRequest.StuInfoItemDomain>();
OapiEduHomeworkCreateRequest.StuInfoItemDomain obj9 = new OapiEduHomeworkCreateRequest.StuInfoItemDomain();
list8.Add(obj9);
obj9.StuName = "王三";
obj9.StuId = "234234";
obj6.ClassStu= list8;
req.SelectStu_ = list5;
req.Identifier = "234234";
req.Attributes = "234324";
req.TargetRole = "student";
req.BizCode = "SONGSHU";
req.Status = "SENDED";
req.ScheduledRelease = "Y";
req.ScheduledTime = "2020-04-20 00:00:00";
req.HwDeadlineOpen = "Y";
req.HwDeadline = 234234234234L;
req.HwType = "RECITE";
OapiEduHomeworkCreateResponse 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 OapiEduHomeworkCreateRequest;
$req->setHwMedia("url");
$req->setHwContent("开始");
$req->setHwTitle("语文作业");
$req->setCourseName("语文");
$req->setHwPhoto("url");
$req->setHwVideo("url");
$req->setTeacherName("李老师");
$req->setTeacherUserid("234234");
$select_class = new ClassInfoItem;
$select_class->class_name="一年级一班";
$select_class->class_id="234234";
$req->setSelectClass(array($select_class));
$select_stu = new SelectStuItem;
$select_stu->class_name="一年级一班";
$select_stu->class_id="234234";
$class_stu = new StuInfoItem;
$class_stu->stu_name="王三";
$class_stu->stu_id="234234";
$select_stu->class_stu = array($class_stu);
$req->setSelectStu(array($select_stu));
$req->setIdentifier("234234");
$req->setAttributes("234324");
$req->setTargetRole("student");
$req->setBizCode("SONGSHU");
$req->setStatus("SENDED");
$req->setScheduledRelease("Y");
$req->setScheduledTime("2020-04-20 00:00:00");
$req->setHwDeadlineOpen("Y");
$req->setHwDeadline("234234234234");
$req->setHwType("RECITE");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/edu/homework/create");

curl -X POST "https://oapi.dingtalk.com/topapi/edu/homework/create" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=d8f682de-cb35-4fe7-8a4f-1432aec68a0d' \
-d 'attributes=234324' \
-d 'biz_code=SONGSHU' \
-d 'course_name=%E8%AF%AD%E6%96%87' \
-d 'hw_content=%E5%BC%80%E5%A7%8B' \
-d 'hw_deadline=234234234234' \
-d 'hw_deadline_open=Y' \
-d 'hw_media=url' \
-d 'hw_photo=url' \
-d 'hw_title=%E8%AF%AD%E6%96%87%E4%BD%9C%E4%B8%9A' \
-d 'hw_type=RECITE' \
-d 'hw_video=url' \
-d 'identifier=234234' \
-d 'scheduled_release=Y' \
-d 'scheduled_time=2020-04-20+00%3A00%3A00' \
-d 'select_class=null' \
-d 'select_stu=null' \
-d 'status=SENDED' \
-d 'target_role=student' \
-d 'teacher_name=%E6%9D%8E%E8%80%81%E5%B8%88' \
-d 'teacher_userid=234234'

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

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

req.hw_media="url"
req.hw_content="开始"
req.hw_title="语文作业"
req.course_name="语文"
req.hw_photo="url"
req.hw_video="url"
req.teacher_name="李老师"
req.teacher_userid="234234"
req.select_class=""
req.select_stu=""
req.identifier="234234"
req.attributes="234324"
req.target_role="student"
req.biz_code="SONGSHU"
req.status="SENDED"
req.scheduled_release="Y"
req.scheduled_time="2020-04-20 00:00:00"
req.hw_deadline_open="Y"
req.hw_deadline=234234234234
req.hw_type="RECITE"
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.homework.create");
add_param(pRequest,"hw_media","url");
add_param(pRequest,"hw_content","开始");
add_param(pRequest,"hw_title","语文作业");
add_param(pRequest,"course_name","语文");
add_param(pRequest,"hw_photo","url");
add_param(pRequest,"hw_video","url");
add_param(pRequest,"teacher_name","李老师");
add_param(pRequest,"teacher_userid","234234");
add_param(pRequest,"select_class","数据结构JSON示例");
add_param(pRequest,"select_stu","数据结构JSON示例");
add_param(pRequest,"identifier","234234");
add_param(pRequest,"attributes","234324");
add_param(pRequest,"target_role","student");
add_param(pRequest,"biz_code","SONGSHU");
add_param(pRequest,"status","SENDED");
add_param(pRequest,"scheduled_release","Y");
add_param(pRequest,"scheduled_time","2020-04-20 00:00:00");
add_param(pRequest,"hw_deadline_open","Y");
add_param(pRequest,"hw_deadline","234234234234");
add_param(pRequest,"hw_type","RECITE");
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.homework.create', {
	'hw_media':'url',
	'hw_content':'开始',
	'hw_title':'语文作业',
	'course_name':'语文',
	'hw_photo':'url',
	'hw_video':'url',
	'teacher_name':'李老师',
	'teacher_userid':'234234',
	'select_class':'数据结构JSON示例',
	'select_stu':'数据结构JSON示例',
	'identifier':'234234',
	'attributes':'234324',
	'target_role':'student',
	'biz_code':'SONGSHU',
	'status':'SENDED',
	'scheduled_release':'Y',
	'scheduled_time':'2020-04-20 00:00:00',
	'hw_deadline_open':'Y',
	'hw_deadline':'234234234234',
	'hw_type':'RECITE'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "result":12321323,
    "success":true,
    "errcode":0,
    "errmsg":"demo"
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.edu.homework.create (家校本发送作业)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ