API开发文档 - 道一云

开发说明

开发说明

功能说明：新增新闻动态
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/news/addNews.do?token=token&corpId=corpId

请求包体：

参数：news
{
    "creator":"123456",
    "range":"1",
    "userIds":"cbbf7e9ab38549d3822476feabefdec2|219e2c12f7019856ae377910ff9a",
    "dynamicTypeId":"2e7a604dfa2c4291a11e519050693f8b",
    "title":"这是标题",
    "summary":"summary",
    "editorContent":"这是正文",
    "coverImage":"http://shp.qpic.cn/bizmp/ck4hSGq23RiaoFuE4XGD9OdXCicJBSDKsGZ8TF152Pt5icWRnPGfZKicWA/100",
    "isComment":"0",
    "isDisplayCoverImage":"0",
    "isSecret":"0",
    "isSendMsg":"0",
    "msgType":"0",
    "thirdPartUrl":"https://www.baidu.com/",
    "thirdPartTips":"第三方提示语",
    "isOpen":"1",
    "shareComment":"1"
}

请求参数说明：

参数	说明	类型	是否必须	备注
token	用于验证	String	是
corpId	公司唯一标识	String	是
news	参数	String	是	通过key-value的方式传递参数
creator	后台账号id	String	否	若为空，则默认为超管
range	公告可见范围	String	是
range	1.为所有人，3.为特定对象	String	是
userIds	用户id,多个以“\|”进行分隔	String	否	range为3时，不可为空
dynamicTypeId	公告类型id	String	是	可通过公告类型接口进行获取
title	公告标题	String	是
summary	公告摘要	String	是
editorContent	公告正文	String	是
coverImage	封面图片地址	String	否
isComment	是否允许评论	String	否	默认为0
isComment	0可以，1不可以	String	否	默认为0
isDisplayCoverImage	是否将封面图片显示在正文中	String	否	默认为0
isDisplayCoverImage	0显示，1不显示	String	否	默认为0
isSecret	是否保密，0非保密，1为保密	String	否	默认为0
isSendMsg	是否推送消息:1-发送；0-不发	int	否	默认为1
msgType	消息类型(0: 图文消息, 1: 第三方页面)	int	否	默认为0
thirdPartUrl	第三方页面地址	String	否	msgType为1时，不能为空
isOpen	是否开启外部分享	int	否	默认为0
shareComment	外部分享是否显示评论	String	否	默认为0

SDK调用示例：

        NewsJsonVO newsJsonVO = new NewsJsonVO();
        //设置后台账号,若为空，则默认为超管
        newsJsonVO.setCreator("123456");
        //设置是否开启外部分享
        newsJsonVO.setIsOpen(1);
        //设置外部分享是否显示评论
        newsJsonVO.setShareComment("1");
        //设置可见范围
        newsJsonVO.setRange("1");
        //设置用户账号id
        newsJsonVO.setUserIds("f4045fdbea8d7818f7da1c9c7ce99576");
        //设置公告类型id
        newsJsonVO.setDynamicTypeId("357d6d49a67040208eb91509b47a402a");
        //设置公告标题
        newsJsonVO.setTitle("这是标题title");
        //设置公告摘要
        newsJsonVO.setSummary("这是摘要summary");
        //设置公告正文
        newsJsonVO.setEditorContent("这是正文content");
        //设置封面图片地址
        newsJsonVO.setCoverImage("http://shp.qpic.cn/bizmp/ck4hSGq23RiaoFuE4XGD9OdXCicJBSDKsGZ8TF152Pt5icWRnPGfZKicWA/100");
        //设置是否允许评论：0可以，1不可以
        newsJsonVO.setIsComment("0");
        //设置是否将封面图片显示在正文中：0显示，1不显示
        newsJsonVO.setIsDisplayCoverImage("0");
        //设置是否保密，0非保密，1为保密
        newsJsonVO.setIsSecret("0");
        //设置是否推送消息:1-发送；0-不发
        newsJsonVO.setIsSendMsg(1);
        //设置消息类型(0: 图文消息,  1: 第三方页面)
        newsJsonVO.setMsgType(0);
        //设置第三方页面地址
        newsJsonVO.setThirdPartUrl("https://www.baidu.com/");
        //设置第三方提示语
        newsJsonVO.setThirdPartTips("第三方提示语");
        NewsApi newApi = QwSdkUtil.getInter(NewsApi.class);
        newApi.addNews(QwSdkUtil.getCacheToken(),newsJsonVO);

返回结果：

{
    "code":"0",
    "desc":"成功",
    "data":{

    }
}

返回参数说明：

企业微信

新增新闻动态

开发说明