这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
|
短信:sendsms_batch [2017/09/28 07:30] admin |
短信:sendsms_batch [2024/04/26 03:56] (当前版本) |
||
|---|---|---|---|
| 行 3: | 行 3: | ||
| **请求地址** | **请求地址** | ||
| <code> | <code> | ||
| - | https://api.ucpaas.com/ol/sms/sendsms_batch | + | http://open2.ucpaas.com/sms-server/templatesms |
| </code> | </code> | ||
| 行 18: | 行 18: | ||
| **JSON 请求示例**\\ | **JSON 请求示例**\\ | ||
| ^参数 ^类型 ^约束 ^描述 ^示例 ^ | ^参数 ^类型 ^约束 ^描述 ^示例 ^ | ||
| - | |sid|String|必填|用户的账号唯一标识“Account Sid”，在开发者控制台获取（[[短信:authentication_sms#Token 和 sid|位置]]）|39467b989d087c2d92c6132184a365d8| | + | |clientid|String|必填|用户的账号唯一标识“clientid”，在开发者控制台获取(账号管理->子账号管理->子账号id)|bxxxxx9| |
| - | |token|String|必填|用户密钥“Auth Token”，在开发者控制台获取（[[短信:authentication_sms#Token 和 sid|位置]]）|23f757bad208226ec301e117e40006ed| | + | |password|String|必填|用户密钥“password”，在开发者控制台获取（账号管理->子账号管理->接口管理（密码md5 32位小写））|c719c6dxxxxxxxxxa50a7490ee05| |
| - | |appid|String|必填|创建应用时系统分配的唯一标示（[[短信:authentication_sms#appid|位置]]）|2d92c6132139467b989d087c84a365d8| | + | |templateid|String|必填|在开发者控制台获取（短信模板->模板管理-模板ID（名字是模板库的是新接口，旧接口模板是老的接口 2个不通用）），查看该模板ID|154501| |
| - | |templateid|String|必填|创建短信模板时系统分配的唯一标示,可在后台短信产品->选择接入的应用->短信模板-模板ID，查看该模板ID（[[短信:authentication_sms#templateId|位置]]）|154501| | + | |param|String|选填|模板中的替换参数，如该模板不存在参数则无需传该参数或者参数为空，如果有多个参数则需要写在同一个字符串中，以分号分隔 （如："a;b;c"），参数中不能含有特殊符号"【】"和","|87828;3| |
| - | |param|String|选填|模板中的替换参数，如该模板不存在参数则无需传该参数或者参数为空，如果有多个参数则需要写在同一个字符串中，以英文逗号分隔 （如："a,b,c"），参数中不能含有特殊符号"【】"和","|87828,3| | + | |mobile|String|必填|支持国内外多个手机号码|国内:18088888888 国际号码 00+国际区号+国际号码| |
| - | |mobile|String|必填|接收的手机号，多个手机号码以英文逗号分隔 （如："18011984299,18011801180"），最多单次支持100个号码，如果号码重复，则只发送一条，暂仅支持国内号码|18011984299,18011801180| | + | |
| |uid|String|选填|用户透传ID，随状态报告返回|2d92c6132139467b989d087c84a365d8| | |uid|String|选填|用户透传ID，随状态报告返回|2d92c6132139467b989d087c84a365d8| | ||
| - | |||
| <code json> | <code json> | ||
| { | { | ||
| - | "sid":"39467b989d087c2d92c6132184a365d8", | + | "clientid":"bxxxxx9", |
| - | "token":"23f757bad208226ec301e117e40006ed", | + | "password":"c719c6dxxxxxxxxxa50a7490ee05", |
| - | "appid":"2d92c6132139467b989d087c84a365d8", | + | "mobile":"18088888888,18888888888", |
| - | "templateid":"154501", | + | "templateid":"154501", |
| - | "param":"87828,3", | + | "param":"87828;3" |
| - | "mobile":"18011984299", | + | |
| - | "uid":"2d92c6132139467b989d087c84a365d8" | + | |
| } | } | ||
| </code> | </code> | ||
| 行 40: | 行 36: | ||
| **JSON 响应示例**\\ | **JSON 响应示例**\\ | ||
| ^参数 ^类型 ^描述 ^示例 ^ | ^参数 ^类型 ^描述 ^示例 ^ | ||
| - | |code|String|状态码|000000| | ||
| - | |msg|String|对应状态码的信息|例如："OK"| | ||
| - | |count_sum|String|总计费条数|3| | ||
| - | |create_date|String|创建时间,格式YYYY-MM-DD hh:mm:ss|2017-08-28 19:08:28| | ||
| - | |report|String|<html><b>响应数组</b></html>| | | ||
| |code|String|状态码|0| | |code|String|状态码|0| | ||
| - | |msg|String|对应状态码的信息|例如："OK"| | + | |msg|String|对应状态码的信息|例如："成功"，"不成功有对应的错误信息"| |
| - | |smsid|String|短信唯一id|f96f79240e372587e9284cd580d8f953| | + | |total_fee|String|短信总计费条数|2| |
| - | |mobile|String|手机号码|18088888888| | + | |mobile|String|手机号码|18088888888,18888888888| |
| + | |fee|String|成功发送的短信计费条数|1| | ||
| + | |sid|String|用于匹配状态报告|604628820812644352| | ||
| |uid|String|请求时透传的uid|2d92c6132139467b989d087c84a365d8| | |uid|String|请求时透传的uid|2d92c6132139467b989d087c84a365d8| | ||
| - | |count|String|计费条数|1| | ||
| - | |||
| <code json> | <code json> | ||
| { | { | ||
| - | "code":"000000", | + | "code": 0, |
| - | "msg":"OK", | + | "data": [ |
| - | "count_sum":"3", | + | { |
| - | "create_date":"2017-08-28 19:08:28", | + | "fee": 1, |
| - | "uid":"", | + | "mobile": "18088888888", |
| - | "report":[ | + | "sid": "604697795961569280" |
| - | { | + | }, |
| - | "code":"0", | + | { |
| - | "msg":"OK", | + | "fee": 1, |
| - | "smsid":"f96f79240e372587e9284cd580d8f953", | + | "mobile": "18888888888", |
| - | "mobile":"18011984299", | + | "sid": "604697795961569281" |
| - | "count":"1" | + | } |
| - | },{ | + | ], |
| - | "code":"1014", | + | "msg": "成功", |
| - | "msg":"手机号码格式错误", | + | "total_fee": 2, |
| - | "smsid":"cdawqes40e372587e9284cd580d8f953", | + | "uid": "" |
| - | "mobile":"1801198429", | + | } |
| - | "count":"1" | + | |
| - | },{ | + | |
| - | "code":"1005", | + | |
| - | "msg":"对同个手机号码发送频率超过限制", | + | |
| - | "smsid":"dadwewa2372587dse9284cd580d8f953", | + | |
| - | "mobile":"18011984299", | + | |
| - | "count":"1" | + | |
| - | } | + | |
| - | ] | + | |
| - | } | + | |
| </code> | </code> | ||
| - | =====相关资料===== | + | |
| - | [[:sms_sdk|SDK下载]] [[:error_code|返回码]] | + | |
