调用形式

https://xtapi.uincall.com/api/sms/sendMsg.action

调用方式

Post

传入参数

序号 名称 是否必填 说明
1 appver 应用版本值:1
2 user 登录用户名
3 secret 计算sercert请阅读1 2 3(不能直接拿3获取到的token直接赋值给当前接口的secret进行调用)
4 timestamp 当前时间,服务端会验证时间有效性,如果与服务端时间差大于 10 分钟则请求无效。
5 account 企业号码
6 corpId 企业ID
7 data 发送的短信内容,JSONArray格式,数量和模板中变量个数匹配,且变量内容只能包含中文,数字,英文短横杠(-),逗号(,),顿号(、),句号(.),冒号(:),点(•),井号(#),波浪号(~),中文双引号(“”),加号(+),最多支持5个变量。示例:短信模板为:您的账户余额:{0}元,如有疑问,请联系客服人员。客服电话{1} data:[“1010.20”,”029-86145678”]平台会自动和模板匹配,生成短信:您的账户余额:1010.20元,如有疑问,请联系客服人员。客服电话029-86145678 。
8 mobile 接收短信的手机号码多个手机号码,英文逗号分隔,上限100个。
9 templateId 模板编号客户提供短信模板到优音工作人员,工作人员在管理平台审核通过后,提供给客户该编号。

回应参数

序号 名称 是否必填 说明
1 errcode 0为成功,其它为失败。
2 errmsg 结果解释。
3 serviceSn 短信的流水号
4 data json对象
4.1 smsWords data中参数,
单条短信字数
4.2 smsNum data中参数,
发送条数,仅供参考
5 msg 短信内容

使用样例

调用:

url:
    http://xtapi.uincall.com/api/sms/sendMsg.action
data: ["13810443533","33333344"]
datas URL编码后:%5b%2213810443533%22%2c%2233333344%22%5d

post 数据:
appver=1&user=4006090002_dev&account=4006090002&timestamp=20160907100100&data=%5b%2213810443533%22%2c%2233333344%22%5d&mobile=18311338668&templateId=fe33223333434&secret=b553c1d4430d2825ac93d1f51d6c658c&corpId=a8d69d52-256b-49b7-be1e-f1f03ab9f771c

响应:

{
    "errcode": 0,
    "msg": "【优音X】你好这是一个阅信模板变量1拒收请回复R",
    "result": "",
    "total": 0,
    "data": {
        "smsWords": 24,
        "smsNum": 0
        },
    "errmsg": "发送成功",
    "serviceSn": "d342f740-e17a-4f55-81dd-09d59b635d96"
}
文档更新时间: 2026-06-02 14:51   作者:admin