梦网云通讯平台个性化短信API接口multi_send
请求URL
http://ip:port/sms/v2/std/multi_send
请求方式
POST
请求参数说明
参数 | 类型 | 是否必须 | 描述 | 示例 |
userid | string | 是 | 用户账号:长度最大6个字符,统一大写 | 示例:J10003 |
pwd | string | 是 | 用户密码:定长小写32位字符。密码规则详见“3.1鉴权规则” | 示例: 密码明文模式:111111 密码加密模式: 账号:J10003 密码:111111 固定字符串:00000000 时间戳:0803192020 MD5加密之前的对应字符串: J10003000000001111110803192020 MD5加密之后的密码字符串: 26dad7f364507df18f3841cc9c4ff94d |
timestamp | string | 否 | 时间戳:24小时制格式:MMDDHHMMSS,即月日时分秒,定长10位,月、日、时、分、秒每段不足2位时左补0,密码选择MD5加密方式时必填该参数,密码选择明文方式时则不用填写 | 示例:0803192020 |
multimt | string | 是 | 个性化信息详情:详见下表 3-2。 multimt中最多可支持100个手机号的个性化信息 |
|
表 3-1
multimt包结构参数说明:
参数 | 类型 | 是否必须 | 描述 | 示例 |
mobile | string | 是 | 单个手机号:号码规则详见“3.2手机号码规则” |
|
content | string | 是 | 短信内容:最大支持350个字,一个字母或一个汉字都视为一个字。 编码方式: | 示例: 短信内容:“欢迎使用本接口” 短信内容进行urlencode编码后: %b2%e2%ca%d4%b6%cc%d0%c5 |
svrtype | string | 否 | 业务类型:最大可支持10个长度的英文字母、数字组合的字符串 | 示例:SMS001 |
exno | string | 否 | 扩展号:长度不能超过6位,注意通道号+扩展号的总长度不能超过20位,若超出则exno无效,如不需要扩展号则不用提交此字段或填空 | 示例:0006 |
custid | string | 否 | 用户自定义流水号:该条短信在您业务系统内的ID,比如订单号或者短信发送记录的流水号。填写后发送状态返回值内将包含这个用户自定义流水号。 最大可支持64位的ASCII字符串:字母、数字、下划线、减号,如不需要则不用提交此字段或填空 | 示例: b3d0a2783d31b21b8573 |
exdata | string | 否 | 自定义扩展数据:额外提供的最大64个长度的ASCII字符串:字母、数字、下划线、减号,作为自定义扩展数据,填写后,状态报告返回时将会包含这部分数据,如不需要则不用提交此字段或填空 |
|
表 3-2
返回参数说明
参数 | 类型 | 描述 | 示例 |
result | int | 个性化群发请求处理结果: 0:成功 非0:失败,详见4错误代码表 | 示例:0 |
msgid | long (64位) | 平台流水号:返回个性化群发第一条记录中的msgid,非0,64位整型, 对应Java和C#的long,不可用int解析。 result非0时,msgid为0 | 示例: 9223372036854775808 注意:msgid允许出现负数 |
custid | string | 用户自定义流水号:返回网关生成的平台流水号 result非0时,custid为空 |
|
表 3-3