消息推送

POST

/api/open/messagecenter/send/v1/message

最后修改时间：2025-03-26 05:42:45

责任人：未设置

接口依赖参数可参考：消息推送文档说明

请求参数

Query 参数

project

string

可选

项目id或者项目编码。可由实施提供或者通过项目列表接口获取(http://aiot.docs.chn-das.com/api-139664251)

默认值:

1192410229407772672

Header 参数

Authorization

string

可选

默认值:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU

Body 参数application/json

templateCode

string

必需

消息模板编码。参考参考消息推送文档说明-创建消息模板，获取消息模板编码

contentMap

object

必需

消息模板中内容占位变量的 key - 实际值键值对。参考消息推送文档说明-创建消息模板，获取消息模板内容变量
例如模板内容 ${info}即将到期，请尽快处理！
"contentMap" : { "info": "实际值"}
用户得到的完整消息内容：模板内容实际值即将到期，请尽快处理！

target

array[string]

必需

消息接收方。与 targetType 搭配使用，注意枚举值, 推荐值是 aiot用户id

targetType

integer

必需

消息接收方类型，传值： 1 - aiot用户id

isRouteType

boolean

可选

是否自动获取消息模板启用的渠道， true - 是， false - 否。此参数为true的情况下 types 参数无效

types

integer

可选

指定消息渠道类型进行发送。 1 - 短信 - SMS, 2 - 邮箱 - EMAIL, 3 - 微信小程序 - WECHAT_APPLET, 4 - APP - APP
, 5 - 企业微信 - ENTERPRISE_WECHAT, 6 - 站内信 - INNER. 默认站内信, 7 - 钉钉, 8 - 我家云。
isRouteType 为true时此字段逻辑无效，请注意

url

string

可选

消息链接。用于点击消息详情跳转使用

示例

{
  "templateCode": "消息模板编码",
  "target": [
    "aiot用户id"
  ],
  "contentMap": {},
  "targetType": 1,
  "types": [
    1
  ],
  "isRouteType": false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/api/open/messagecenter/send/v1/message?project=1192410229407772672' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU' \
--header 'Content-Type: application/json' \
--data-raw '{
  "templateCode": "消息模板编码",
  "target": ["aiot用户id"],
  "contentMap": {},
  "targetType": 1,
  "types": [1],
  "isRouteType": false
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

true

🟠400400响应结构

获取微信公众号渠道配置