云化版接口说明 WebService接口
HTTP接口

发送模版短信

向指定手机号码发送模板短信，模板内可设置部分变量。使用前需要在OpenMAS云化版平台添加短信模板。

本接口适用于非白名单模式用户，携号入网用户一般不推荐使用，使用此功能发送短信，将限制客户侧提交的短信内容。


注意事项

● 模版短信单次只允许提交一个号码


报文示例

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <funMain xmlns="ws.yunmas.com"> <arg0 xmlns=""> { "applicationId": "rMq4g3s8Npq****************F0x8NYuv", "password": "U7xp********c6R", "requestTime": "20191213141516", "sign": "4b505f9c****************0de1489c", "funCode": "1001", "sendTime": "", "extendCode": "22", "tempCode":"SMS-10000022", "sendInfo": [{ "sendId": "1", "mobile": "138****0001", "param": [{ "key": "msg", "value": "888" }] }] } </arg0> </funMain> </soap:Body> </soap:Envelope>


请求参数

OpenMAS云化版平台主要采用WebService方式，接口协议使用SOAP协议。

参数 参数名称 参数说明
applicationId 应用账号(AppKey) 如：rMq4g3s8****************O0KF0x8NYuv
password 应用密码(AppSecret) 如：U7xp******cc6R
requestTime 请求时间 与服务器时间差不能超过5分钟，格式如：20191213141516
sign 接口校验令牌 生成规则请登录OpenMAS云化版平台=>应用管理=>应用列表，对应应用点击操作列查看，查看详情
funCode 服务代码 模版短信必须填写为1001
sendId 短信发送编号 上级为sendInfo
mobile 手机号码 必须是11位手机号码
extendCode 扩展号 如：21001，手机端显示发件人号码10657525123421001
106575251234为集团客户的12位接入号
2为开通接口时配置的编号
1001为客户侧自定义扩展号，一般用于区分不同的业务或系统，或代表特殊意义的数字，如无需要可以不填
接入号+扩展号 总长度不能超过20位
tempCode 模版编号 在应用管理中申请
param 参数信息 如：{"key":"msg","value":"888"}

请求格式

{
"applicationId": "rMq4g3s8Npq****************F0x8NYuv",
"password": "U7xp********c6R",
"requestTime": "20191213141516",
"sign": "4b505f9c***************0de1489c",
"funCode": "1001",
"sendTime": "",
"extendCode": "22",
"tempCode": "SMS-10000022",
"sendInfo": [
     {
        "sendId": "1",
         "mobile": "155****1879",
        "param": [
        {
            "key": "msg",
            "value": "888"
        }
        ]
    }
]
}


响应格式
参数 参数名称 参数说明
resultCode 错误代码 0表示成功，其他表示错误，详细参见错误代码表
sendId 短信发送编号 企业应用侧的短信编号
messageId OpenMAS云化版短信编号 获取的短信发送结果根据该字段匹配
returnCode 错误代码 0表示成功，其他表示错误，详细参见错误代码表

{
"resultCode": "0",
"response": [
    {
        "sendId": "1",
        "messageId": "685083",
        "returnCode": "0"
    }
]
}