用户工具

短信:sendsms

指定模板单发

请求地址

http://open2.ucpaas.com/sms-server/variablesms

请求方式
请求方式:POST,支持HTTPS

注意:为降低遭受恶意攻击的风险,请遵循下述安全策略使用短信发送接口
1、为防止请求被拦截并伪造攻击,请勿将该接口直接用于前端开发。如需由前端发送短信,请对本接口进行二次封装并且强制要求二次验证(例如:图形验证码、滑块验证);
2、在功能上线前,进入开发者控制后台绑定服务器IP白名单,以禁止其法IP发送请求攻击;
3、使用https协议,减少信息被拦截和伪造的风险;

JSON 请求示例

参数 类型 约束 描述 示例
clientidString必填用户的账号唯一标识“clientid”,在开发者控制台获取(账号管理→子账号管理→子账号id)bxxxxx9
passwordString必填用户密钥“password”,在开发者控制台获取(账号管理→子账号管理→接口管理(密码md5 32位小写))c719c6dxxxxxxxxxa50a7490ee05
templateidString必填在开发者控制台获取(短信模板→模板管理-模板ID(名字是模板库的是新接口,旧接口模板是老的接口 2个不通用)),查看该模板ID154501
paramString选填模板中的替换参数,如该模板不存在参数则无需传该参数或者参数为空,如果有多个参数则需要写在同一个字符串中,以分号分隔 (如:“a;b;c”),参数中不能含有特殊符号“【】”和“,”87828;3
mobileString必填支持国内外单个手机号码国内:18088888888 国际号码 00+国际区号+国际号码
uidString选填用户透传ID,随状态报告返回2d92c6132139467b989d087c84a365d8
{
"clientid":"bxxxxx9",
"password":"c719c6dxxxxxxxxxa50a7490ee05",
"mobile":"18088888888",
"templateid":"154501",
"param":"87828;3"
}

JSON 响应示例

参数 类型 描述 示例
codeString状态码0
msgString对应状态码的信息例如:“成功”,“不成功有对应的错误信息”
total_feeString短信总计费条数1
mobileString手机号码18088888888
sidString用于匹配状态报告604628820812644352
uidString请求时透传的uid2d92c6132139467b989d087c84a365d8
{
    "code": 0,
    "data": [
        {
            "fee": 1,
            "mobile": "18088888888",
            "sid": "604628820812644352"
        }
    ],
    "msg": "成功",
    "total_fee": 1,
    "uid": ""
}					

页面工具