查询文章列表旧版SDK
更新于 2023-01-18
本接口在互动服务窗内暂无对应产品功能
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
企业内部应用 | 是 | 企业内部服务号素材权限 | |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
基本信息
请求方式:POST
请求地址:https://oapi.dingtalk.com/topapi/material/article/list
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 30c9a84136943eaxxxx | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
unionid | String | 是 | lO44Wvqzy7siE | 服务号的unionid,可通过查询服务号列表接口获取。 |
page_size | Number | 是 | 5 | 每页条数。 |
page_start | Number | 是 | 1 | 页码。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
items | ArticleDTO[] | 文章列表。 | |
article_id | Number | 129003 | 文章id。 |
title | String | 标题1 | 标题。 |
thumb_media_id | String | @lALPBbCc1XuaP_rNAljNAlg | 封面图。 |
publish_status | Number | 1 | 发布状态:
说明 文章第一次发布后,状态置为1,已发布文章支持修改,修改后此状态保持为1,每次修改文章后需要再次发布内容才会生效。 |
publish_time | Number | 1442027997327 | 发布时间。 说明 文章成功发布之后才有返回值。 |
create_time | Number | 1442027997327 | 创建时间。 |
update_time | Number | 1442027997327 | 更新时间。 |
content | String | article_backup_raw_content_xxxx | 文章内容。 |
url | String | https://dingtalk.com?articleId=17001 | 文章跳转链接。 说明 文章成功发布之后才有返回值。 |
digest | String | 摘要1 | 文章摘要。 |
total_count | Number | 100 | 文章总数。 |
errcode | Number | 0 | 返回码。 |
errmsg | String | ok | 返回码描述。 |
item_count | Number | 5 | 本页条数。 |
request_id | String | 8g4j3xpjuuly | 请求ID。 |
示例
请求示例(HTTP)
请求正文
请求示例(JAVA SDK)
返回示例