企业内部应用服务端API消息接口
【摘要】 消息接口该接口用于企业应用中需要消息通知的场景。通过本接口，应用可以将信息推送给WeLink端用户。接口说明请求方式： POST(HTTPS)请求地址： https://open.welink.huaweicloud.com/api/messages/v3/send认证方式： access_token，请参考获取access_token原V1、V2接口可以继续使用，但不推荐，文档不再体现。请...
消息接口
该接口用于企业应用中需要消息通知的场景。通过本接口，应用可以将信息推送给WeLink端用户。
接口说明
请求方式： POST(HTTPS)
请求地址： https://open.welink.huaweicloud.com/api/messages/v3/send
认证方式： access_token，请参考获取access_token
原V1、V2接口可以继续使用，但不推荐，文档不再体现。
请求头部：
Content-Type: application/json x-wlk-Authorization: access_token
请求参数：
{ "msgRange": 0,
"toUserList": ["john@welink", "john@1234"], "msgTitle": "{\"EN\": \"hello world\", \"CN\": \"你好\"}", "msgContent": "{\"CN\": \"欢迎使用\", \"EN\":\"Welcome\"}", "urlType": "html", "urlPath": "h5://demo.com", "msgOwner": "John", "createTime": "1487289600000"}请求参数说明：
| 参数 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| toUserList | List | 是 | 成员ID列表（消息接收者，多个接收者用','分隔，最多支持1000个）。 |
| msgRange | String | 是 | 0：按用户推送 |
| msgTitle | String | 是 | 标题，不超过128个字节，超过会自动截断，如果不需要双语，可直接传string如“出差电子流” ,需要双语则参考请求包体示例，传入{json}string对象。 |
| msgContent | String | 是 | 描述，不超过512个字节，超过会自动截断，如果不需要双语，可直接传string如“张三提交了一个去上海的出差申请” ，双语场景同上。 |
| urlType | String | 是 | 链接类型定义，如"html",则可跳转到http://url地址。 |
| urlPath | String | 是 | 点击后跳转的链接，如需要跳转到微码，参考推送消息实现免登。 |
| msgOwner | String | 是 | 消息所有者，如“差旅管理”。 |
| createTime | String | 否 | 消息创建时间，可不传系统将自动生成推送时间。 |
请求示例：
curl -X POST \
'https://open.welink.huaweicloud.com/api/messages/v3/send?=' \
-H 'Content-Type: application/json' \
-H 'x-wlk-Authorization: access_token' \
-d '{"请求参数 json格式"}'响应格式说明
正常返回结果：
{ "code":"0", "message":"ok"}异常返回结果：
{ "code":"51019", //错误码
"message":"用户未关注或者推送账号不存在", //错误提示
"failedUserId":["zhangsan@welink", "lisi@welink"] //因为userId推送失败，会显示失败人员信息}返回参数说明：
| 参数 | 说明 |
|---|---|
| code | 数据正常返回“0”，如果发生错误，会返回对应的错误码。 |
| message | 返回信息，包括接口请求发生错误时的详细信息。 |
| failedUserId | 推送失败的userId |
错误码说明：
| 错误码 | 说明 |
|---|---|
| 51002 | 推送消息异常 |
| 51003 | 没有传入公众号ID |
| 51010 | 该公众号在系统中不存在 |
| 51018 | 单次发送用户数最大1000人 |
| 51019 | 不能给非粉丝用户推送消息 |
| 51036 | 用户未登录 |
| 51042 | 用户列表不能为空 |
【版权声明】本文为华为云社区用户原创内容，未经允许不得转载，如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱：
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论（0）