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

dingtalk.oapi.material.news.get (获取消息卡片详情)

获取消息卡片素材详情

公共参数

环境	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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
unionid	String	必须	jYdrJoCmTo0iE		服务号的unionid
media_id	String	必须	P16mHftLYX8iE		消息卡片素材id

响应参数

名称	类型	示例值	描述
errmsg	String	ok	错误信息
errcode	Number	0	错误码
media_id	String	mvFiiRhuwt5IiE	卡片素材id
update_time	Number	1560137792000	消息卡片更新时间
articles	ArticleDTO []		文章列表
└ article_id Number 114002 文章id └ title String 这是一个新的标题标题 └ content String <p>第一个段落</p> 文章内容 └ thumb_media_id String @lALPBbCc1XuaP_rNAljNAlg 封面图片的素材id └ publish_status Number 1 publish_status，发布状态，0 未发布，1 已发布。文章第一次发布后，状态置为1，已发布文章支持修改，修改后此状态保持为1，每次修改文章后需要再次发布内容才会生效。 └ publish_time Number 1560137792000 发布时间 └ user_view_count Number 1 已读用户数 └ total_view_count Number 12 阅读次数 └ create_time Number 1560137792000 文章创建时间 └ update_time Number 1560137792000 文章更新时间 └ url String https://content.dingtalk.com/article?articleId=1234 文章链接 └ digest String 关于这篇文章... 摘要

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/material/news/get");
OapiMaterialNewsGetRequest req = new OapiMaterialNewsGetRequest();
req.setUnionid("jYdrJoCmTo0iE");
req.setMediaId("P16mHftLYX8iE");
OapiMaterialNewsGetResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

JSON示例

{
    "errmsg":"ok",
    "errcode":0,
    "media_id":"mvFiiRhuwt5IiE",
    "update_time":1560137792000,
    "articles":[
        {
                "article_id":114002,
                "title":"这是一个新的标题",
                "content":"<p>第一个段落<\/p>",
                "thumb_media_id":"@lALPBbCc1XuaP_rNAljNAlg",
                "publish_status":1,
                "publish_time":1560137792000,
                "user_view_count":1,
                "total_view_count":12,
                "create_time":1560137792000,
                "update_time":1560137792000,
                "url":"https:\/\/content.dingtalk.com\/article?articleId=1234",
                "digest":"关于这篇文章..."
        }
    ]
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.material.news.get (获取消息卡片详情)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ