这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
|
短信:sendsms [2017/09/28 07:29] admin |
短信:sendsms [2024/04/26 03:54] (当前版本) |
||
|---|---|---|---|
| 行 3: | 行 3: | ||
| **请求地址** | **请求地址** | ||
| <code> | <code> | ||
| - | https://api.ucpaas.com/ol/sms/sendsms | + | http://open2.ucpaas.com/sms-server/variablesms |
| </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| | + | |
| |uid|String|选填|用户透传ID，随状态报告返回|2d92c6132139467b989d087c84a365d8| | |uid|String|选填|用户透传ID，随状态报告返回|2d92c6132139467b989d087c84a365d8| | ||
| <code json> | <code json> | ||
| { | { | ||
| - | "sid":"39467b989d087c2d92c6132184a365d8", | + | "clientid":"bxxxxx9", |
| - | "token":"23f757bad208226ec301e117e40006ed", | + | "password":"c719c6dxxxxxxxxxa50a7490ee05", |
| - | "appid":"2d92c6132139467b989d087c84a365d8", | + | "mobile":"18088888888", |
| - | "templateid":"154501", | + | "templateid":"154501", |
| - | "param":"87828,3", | + | "param":"87828;3" |
| - | "mobile":"18011984299", | + | |
| - | "uid":"2d92c6132139467b989d087c84a365d8" | + | |
| } | } | ||
| </code> | </code> | ||
| 行 39: | 行 36: | ||
| **JSON 响应示例**\\ | **JSON 响应示例**\\ | ||
| ^参数 ^类型 ^描述 ^示例 ^ | ^参数 ^类型 ^描述 ^示例 ^ | ||
| - | |code|String|状态码|000000| | + | |code|String|状态码|0| |
| - | |msg|String|对应状态码的信息|例如："发送成功"，"手机号码不合法"| | + | |msg|String|对应状态码的信息|例如："成功"，"不成功有对应的错误信息"| |
| - | |count|String|计费条数|1| | + | |total_fee|String|短信总计费条数|1| |
| - | |create_date|String|创建时间,格式YYYY-MM-DD hh:mm:ss|2017-08-28 19:08:28| | + | |
| - | |smsid|String|短信唯一id|f96f79240e372587e9284cd580d8f953| | + | |
| |mobile|String|手机号码|18088888888| | |mobile|String|手机号码|18088888888| | ||
| + | |sid|String|用于匹配状态报告|604628820812644352| | ||
| |uid|String|请求时透传的uid|2d92c6132139467b989d087c84a365d8| | |uid|String|请求时透传的uid|2d92c6132139467b989d087c84a365d8| | ||
| <code json> | <code json> | ||
| { | { | ||
| - | "code":"0", | + | "code": 0, |
| - | "msg":"OK", | + | "data": [ |
| - | "count":"1", | + | { |
| - | "create_date":"2017-08-28 19:08:28", | + | "fee": 1, |
| - | "smsid":"f96f79240e372587e9284cd580d8f953", | + | "mobile": "18088888888", |
| - | "mobile":"18011984299", | + | "sid": "604628820812644352" |
| - | "uid":"2d92c6132139467b989d087c84a365d8" | + | } |
| + | ], | ||
| + | "msg": "成功", | ||
| + | "total_fee": 1, | ||
| + | "uid": "" | ||
| } | } | ||
| </code> | </code> | ||
| - | =====相关资料===== | + | |
| - | [[:sms_sdk|SDK下载]] [[:error_code|返回码]] | + | |
