消息

写在前面
接口描述
- C1.发送消息

写在前面

文中将${seq}定义为参数名为seq的参数，相关的表中有参数描述
文中将${timeout*}定义为可选的参数timeout
本文当中所有涉及到时间的参数都使用精确到毫秒的时间戳，例1535595007983表示Thu Aug 30 2018 10:10:07 GMT+0800 (中国标准时间)
本文中涉及到分页的接口使用skip、limit参数，表示跳过skip行取至多limit行，返回头X-Total-Count参数表示查询总行数
所有接口使用HTTP状态码200表示成功，其他状态码表示失败，如有特例将在具体接口中说明

接口描述

C1.发送消息

发送给某个用户

POST /message/v2/notices HTTP/1.1
Host: ${domain}
Authorization: Bearer ${token}
Content-Type: application/json

{
    "to": ${sub},
    "template": ${template_id},
    "url": ${url*},  
    "data": {
        ${keyword}: {
            "value": ${value},
            "color": ${color}
        }
        ...
    }
}

参数名	类型	说明
sub	string	某个用户的ID
template_id	string	模板ID
url	string	如果需要跳转，则填写跳转地址
keyword	string	模板关键字
value	string	模板内容
color	color	模板内容颜色
其他		见`公共请求参数说明`

请求参数示例

{
    "to": "6aeca60613e949f0a16e721faf9f1082",
    "template": "Q57J4mJLPXxiBNTzRqkB93eB_64KLnRmAgNcoRiOMpk",
    "data": {
        "first": {
            "value": "1",
            "color": "#000"
        },
        "keyword1": {
            "value": "2",
            "color": "#000"
        },
        "keyword2": {
            "value": "3",
            "color": "#000"
        },
        "keyword3": {
            "value": "4",
            "color": "#000"
        },
        "keyword4": {
            "value": "5",
            "color": "#000"
        },
        "remark": {
            "value": "6",
            "color": "#000"
        }
    }
}

若发送成功则返回

{
    "code":200
}