Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
  1. 班级圈
  • 通用基础
    • 学段
      • 获取学段元数据列表
    • 学科
      • 获取学科元数据列表
      • 创建学科实例
      • 更新学科实例
      • 删除学科实例
      • 获取学科实例详情
      • 获取学科实例列表
    • 查询教育组织类型
      GET
  • 在线课堂
    • 排课
      • 创建课程
      • 修改课程
      • 删除课程
      • 获取课程详情
      • 获取课程列表
      • 添加课程参与方
      • 获取课程参与方列表
      • 移除课程参与方
    • 授课
      • 开始课程
      • 加入课程
      • 结束课程
      • 回放课程
    • 课堂数据
      • 获取课堂概要数据
      • 获取课堂明细数据
  • 家校通讯录2.0
    • 通讯录信息读取
      • 获取部门详情
      • 获取部门列表
      • 获取人员列表
      • 获取人员详情
      • 获取人员关系列表
      • 获取人员关系详情
    • 通讯录信息写入
      • 添加老师
      • 添加家长
      • 学生调班
      • 添加学生
      • 创建学段
      • 初始化家校架构
      • 创建班级
      • 创建年级
      • 删除老师
      • 删除学生
      • 删除家长关系
      • 删除家校部门
      • 创建自定义部门下的班级
      • 创建自定义校区或部门
    • 获取学生信息
      • 获取学生信息
      • 获取学生ID列表
  • 家庭
    • 家庭Feed同步
      POST
    • 查询家庭孩子信息
      POST
    • 学习推荐数据回流
      POST
    • 静态推荐数据同步
      POST
  • 班级圈
    • 获取班级圈话题列表
      POST
    • 获取班级圈动态列表
      POST
  • 数字化证书
    • 获取数字化证书
      POST
  1. 班级圈

获取班级圈动态列表

POST
http://127.0.0.1/topapi/edu/circle/post/list
服务端API/新教育/班级圈
最后修改时间:2022-08-30 09:19:23
责任人:未设置

说明#

调用本接口获取班级圈动态列表。
服务地址:https://oapi.dingtalk.com

权限#

服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
应用类型是否支持调用权限申请方式API Explorer调试
企业内部应用是开发者后台申请调试
第三方企业应用否——
第三方个人应用否——

请求参数

Query 参数
access_token
string 
必需
调用服务端API授权凭证,可通过获取企业内部应用的access_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
open_feed_query_param
object 
请求结构
可选
cursor
number 
可选
分页游标,第一页传入系统时间,毫秒。返回的数据的时间戳不超过该数值
student_id
string 
可选
学生的userid。
class_id
number 
班级ID。
可选
topic_id
number 
话题ID。
可选
biz_type
number 
可选
业务类型,固定值为4,表示班级圈。
feed_type
number 
可选
动态类型,固定值0。
count
number 
可选
分页大小,最大值20。
user_role
string 
角色,可不传。
可选
userid
string 
可选
当前人登录人userId,如果没有人登录。可以传入班级的老师userid。
示例
{
  "open_feed_query_param": {
    "biz_type": 4,
    "class_id": 26347,
    "count": 10,
    "cursor": 1620704981000,
    "feed_type": 0,
    "student_id": "stu123",
    "topic_id": 19827347,
    "user_role": "老师",
    "userid": "tch123"
  }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/topapi/edu/circle/post/list?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "open_feed_query_param": {
        "biz_type": 4,
        "class_id": 26347,
        "count": 10,
        "cursor": 1620704981000,
        "feed_type": 0,
        "student_id": "stu123",
        "topic_id": 19827347,
        "user_role": "老师",
        "userid": "tch123"
    }
}'

返回响应

🟢200成功
application/json
Body
result
object 
返回结果。
可选
has_more
boolean 
是否还有更多数据。
可选
posts
array [object {9}] 
动态列表。
可选
success
boolean 
是否成功。
可选
errmsg
string 
返回码描述。
可选
errcode
number 
返回码。
可选
示例
{
  "result": {
    "has_more": true,
    "posts": [
      {
        "comments": [
          {
            "comment_id": 0,
            "content": "string",
            "origin_user": {
              "show_name": "string",
              "staff_id": "string"
            }
          }
        ],
        "author": {
          "owner": true,
          "show_name": "string",
          "icon_media_id": "string",
          "title": "string",
          "type": "string",
          "avatar_media_id": "string",
          "nick": "string",
          "is_owner": true,
          "tag": 0,
          "user_role": "string",
          "staff_id": "string"
        },
        "feed_type": 0,
        "biz_id": "string",
        "post_id": 0,
        "create_at": 0,
        "content": {
          "geo_content": "string",
          "text": "string",
          "content_type": 0
        },
        "tags": "string",
        "status": 0
      }
    ]
  },
  "success": true,
  "errmsg": "string",
  "errcode": 0
}
上一页
获取班级圈话题列表
下一页
获取数字化证书
Built with