发送管理

1、文本短信发送

1.1 请求地址

• 请求方式：post
• Content-Type：application/json
• 请求地址：https://cwl.chuanglan.com/api/message/sms/template_send/batch

1.2 请求参数

参数名	类型	是否必传	描述
nonce	string	是	随机数。 可使用uuid
timestamp	string	是	时间戳
signature	string	是	验签加密串。根据验签示例说明进行加密
app_id	string	是	账户app_id。从系统的页面-》系统管理 可以获取
mobiles	string	是	接收手机号码。注意：1、最大支持100个号码 2、JSONStringArray的格式 3、生成一号一链时必传 示例："["18587191949","17321453868","18587191949"]"
template_id	string	是	文本模板id。
params	string	否	动参模板参数赋值。注意：1、JSONObjectArray格式 2、动态模板时必传 3、动参对象和手机号个数一致 4、params中short_chain表示卡片的短链，用来替换解析卡片展示的； 示例："[{"short_chain": "aa","age": "34"}, {"short_chain": "bb","age": "30"}, {"short_chain": "cc","age": "29"}]"
sign	string	是	签名。
uid	string	否	客户定义uid唯一字段。可以跟着状态报告回调的时候回传
need_report	string	是	是否需要状态报告回调。
out_ext_no	string	否	自定义拓展码。

1.3 响应参数

参数名	类型	默认值	描述
code	string		000000 代表成功，其他代表失败，会有 message 错误信息返回
msg	string		提示信息
data	object		返回数据

data数据结构

参数名	类型	是否必传	描述
msg_submit_id	string	是	消息发送批次

{
    "code": "000000",
    "message": "成功",
    "data": {
        "msg_submit_id": "BC202208151850478498596619264"
    }
}

1.4 请求示例

{
    "nonce": "80e33b2f03b44db8b5f7b4114f370602",
    "timestamp": "1659163692047",
    "app_id": "nRYcU4fYExYjw2m8",
    "template_id": "CLSMS202207071932038388591245312",
    "sign": "测试签名",
    "uid": "43a49954946c4482a6a63d9ac80e74a5",
    "need_report": "Y",
    "mobiles": "[\"19937850953\",\"17376563356\",\"18587191949\"]",
    "params": "[{\"short_chain\": \"cl2m.cn/vN7pqo1\"}, {\"short_chain\": \"cl2m.cn/vN7pqo2\"},{\"short_chain\": \"cl2m.cn/vN7pqo3\"}]",
    "signature": "34e6c6a2606e8f4781fc9e5025ebdc2790885de894abbe90ee9ca959e8735bcf"
}

2、活动发送

2.1 请求地址

• 请求方式：post
• Content-Type：application/json
• 请求地址：https://cwl.chuanglan.com/api/v1/activity/send

2.2 请求参数

参数名	类型	是否必传	描述
nonce	string	是	随机数。 可使用uuid
timestamp	string	是	时间戳。
signature	string	是	验签加密串。根据验签示例说明进行加密
app_id	string	是	账户app_id。从系统的页面-》系统管理 可以获取
activity_id	string	是	签名id。
mobiles	string	是	接收手机号码。注意：1、最大支持100个号码 2、JSONStringArray的格式 3、生成一号一链时必传 示例："["18587191949","17321453868","18587191949"]"
card_params	string	否	卡片模板动参传值。注意：1、JSONObjectArray格式 2、动态模板时必传 3、动参对象和手机号个数一致
card_text_params	string	否	卡片文本模板动参传值。注意：与card_params要求一致 4、card_text_params中short_chain表示卡片的短链，用来替换解析卡片模板展示的；
video_params	string	否	普通视频模板动参传值。注意：与card_params要求一致
aim_params	string	否	aim模板动参传值。注意：与card_params要求一致
aim_text_params	string	否	aim文本模板动参传值。注意：与card_params要求一致 4、aim_text_params中short_chain表示卡片的短链，用来替换解析aim模板展示的；
sms_params	string	否	普通文本模板动参传值。注意：与card_params要求一致
uid	string	否	客户定义uid唯一字段。可以跟着状态报告回调的时候回传

2.3 响应参数

参数名	类型	默认值	描述
code	string		000000 代表成功，其他代表失败，会有 message 错误信息返回
msg	string		提示信息
data	object		返回数据

data数据结构

参数名	类型	是否必传	描述
msg_submit_id	string	是	消息发送批次

{
    "code": "000000",
    "message": "成功",
    "data": {
        "msg_submit_id": "202212291725282048628344688"
    }
}

2.4 请求示例

 {
    "signature": "2a38f3423533e96bd074520839f183558a14a6a0acb8d7831dba7f320e4ab9a9",
    "nonce": "1a8ce7919a39495e8e15a9ea8eb74d26",
    "timestamp": "1662050291029",
    "app_id":"0AvyA8opHDqDs6X2",
    "activity_id":"202212011950327468633811111",
    "mobiles":"[\"19937850953\",\"17376563356\"]",
    "card_params":"[{\"card_1\":\"card第一个s1\",\"card_2\":\"card第一个s2\"},{\"card_1\":\"card第二个s1\",\"card_2\":\"card第二个s2\"}]",
    "card_text_params":"[{\"card_text_1\":\"card_text第一个s1\",\"card_text_2\":\"card_text第一个s2\"},{\"card_text_1\":\"card_text第二个s1\",\"card_text_2\":\"card_text第二个s2\"}]",
    "video_params":"[{\"video_1\":\"video第一个s1\",\"video_2\":\"video第一个s2\"},{\"video_1\":\"video第二个s1\",\"video_2\":\"video第二个s2\"}]",
    "aim_params":"[{\"aim_1\":\"aim第一个s1\",\"aim_2\":\"aim第一个s2\"},{\"aim_1\":\"aim第二个s1\",\"aim_2\":\"aim第二个s2\"}]",
    "aim_text_params":"[{\"aim_text_1\":\"aim_text第一个s1\",\"aim_text_2\":\"aim_text第一个s2\"},{\"aim_text_1\":\"aim_text第二个s1\",\"aim_text_2\":\"aim_text第二个s2\"}]",
    "sms_params":"[{\"sms_1\":\"sms第一个s1\",\"sms_2\":\"sms第一个s2\"},{\"sms_1\":\"sms第二个s1\",\"sms_2\":\"sms第二个s2\"}]",
    "uid":"1123123123123zfsadfasdfasd23s_d23"
}