淘宝开放平台

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

钉钉API

dingtalk.oapi.edu.homework.student.comment.list (作业评论列表)

作业评论列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
class_id Number 必须 423434 班级ID
hw_id Number 必须 23434 作业ID
student_id String 必须 3243432423434423434 学生ID
teacher_userid String 必须 2343243 老师userID
biz_code String 必须 SONGSHU 业务编码

响应参数

名称 类型 示例值 描述
result OpenHwCommentResponse [] 23432434 结果
  • └ student_id
  • String
  • 1583755223255
  • 学生ID
  • └ teacher_id
  • String
  • manager3979
  • 老师ID
  • └ teacher_name
  • String
  • 周鹏
  • 老师姓名
  • └ student_name
  • String
  • 刘勇
  • 学生姓名
  • └ photo
  • String
  • 图片
  • └ comment
  • String
  • 比上次有了很大的进步!
  • 评论内容
  • └ attributes
  • String
  • []
  • 扩展属性
  • └ media
  • String
  • 视频
  • └ video
  • String
  • 音频
  • └ comment_time
  • Date
  • 1587995199000
  • 评论时间
  • └ comment_id
  • Number
  • 23423432
  • 评论ID
success Boolean true 是否成功
errcode Number 0 错误编码
errmsg String demo 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/edu/homework/student/comment/list");
OapiEduHomeworkStudentCommentListRequest req = new OapiEduHomeworkStudentCommentListRequest();
req.setClassId(423434L);
req.setHwId(23434L);
req.setStudentId("3243432423434423434");
req.setTeacherUserid("2343243");
req.setBizCode("SONGSHU");
OapiEduHomeworkStudentCommentListResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
    "result":[
        {
                "student_id":"1583755223255",
                "teacher_id":"manager3979",
                "teacher_name":"周鹏",
                "student_name":"刘勇",
                "photo":"",
                "comment":"比上次有了很大的进步!",
                "attributes":"[]",
                "media":"",
                "video":"",
                "comment_time":"1587995199000",
                "comment_id":23423432
        }
    ],
    "success":true,
    "errcode":0,
    "errmsg":"demo"
}

异常示例

  • JSON示例
1
2
3
4
{
    "errcode":88,
    "errmsg":"ding talk error"
}

错误码解释

错误码 错误描述 解决方案

API工具

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

如何获得此API

FAQ

我要提问
返回
顶部