应用场景:第三方服务根据业务场景需要调用“晋来办”的应用消息推送通知用户悉知,包括APP、PC、小程序消息。
接口名称:应用通知发送接口
接口地址:能力开放平台域名/openplatform/open/push.action?send
数据类型:JSON
编码格式:x-www-form-urlencoded
参数说明:
(1)title标题长度限制20个汉字,中英文都算一个
(2)content推送内容长度限制50个汉字,中英文都算一个
参数 | 参数类型 | 说明 | |
---|---|---|---|
appcode | String | 应用系统接入代码 | |
modulecode | String | 服务模块接入代码 | |
userid | string | 接收者用户的userID(晋来办) | |
title | String | 推送标题 标题长度限制20个汉字,中英文都算一个 | |
content | String | 推送内容 推送内容长度限制50个汉字,中英文都算一个 | |
url | String | 推送跳转链接(非必填) | |
timestamp | String | 时间戳(10 位数字) | |
sign | String | 用其他字段和 appcode算出来的加密字符串 | |
返回参数说明 | |||
参数 | 参数类型 | 说明 | |
status | String | 发送状态 200:成功 300:异常 302:接口没有权限,请与管理员联系 | |
msg | String | 信息说明 | |
requestid | String | 平台业务编号 | |
JSON示例 | |||
{ state: 200, msg: 应用消息提交成功, requestId : ff8080816b872255016b8724e3570000 } | |||
state错误码说明 | |||
参数 | 说明 | ||
200 | 提交成功(不代表发送成功) | ||
300 | 系统内部错误 | ||
501 | 厂商信息异常(appcode错误) | ||
502 | 缺少参数(接收者用户id,标题、内容或时间戳等未设置或为空) | ||
503 | 验签错误(传入sign和系统生成sign不匹配) | ||
504 | 时间戳过旧timestamp | ||
505 | 用户信息错误(传入用户未匹配) |