文档介绍:WebService 接口说明
接口定义
SendMessage 批量发送短信方法(不支持同一userID的多线程调用)
public SendState SendMessage(string UserId, string Password, string Msg, string Destnumbers)
参数说明:
参数
描述
UserId
用户Id(平台识别的用户号码), 49字节以内。
Password
密码, 99字节以内
Msg
短信内容, 159字节以内
Destnumbers
目标号码,用分号(;)分隔,在一万条以内。
返回值
public class SendState
{
public int state;
public string WrongNumbers;
public string YDGroupId; // 发送到移动的短信的批次号
public string LTGroupId; // 发送到联通的短信的批次号
}
state 0: ess
2: 失败需要重发
4: 内容不合法
5: 身份验证错误
6: 服务器错误
8: 短信数超过可用数
12: 该用户不允许使用子用户ID
13: 错误的号码格式
WrongNumbers 为错误的目标号码,用分号分隔,目前只是按移动和联通进行过滤。即不属于联通或移动的号码会被放入这里。
YDGroupId, LTGroupId 发送的短信所属的批次号,用于以后查询短信的发送状态。
SendMessageWithSub 发送短信时带有子号码(不支持同一userID的多线程调用)
public SendState SendMessageWithSub(string UserId, string SubId, string Password, string Msg, string Destnumbers)
参数说明
参数
描述
UserId
用户Id(平台识别的用户号码),49字节以内。
SubId
子用户号码(14位以内), 14字节以内
Password
密码, 90字节以内
Msg
短信内容,159字节以内
Destnumbers
目标号码,用分号(;)分隔,一万条以内
返回值
同SendMesseage
QueryFailedMessage 查询失败短信
public MessageStateResponse QueryFailedMessage(string UserId, string Password, int groupId)
参数说明
参数
描述
UserId
用户Id(平台识别的用户号码) ,49字节以内。
Password
密码,99字节以内。
groupId
发送的短信所属的批次号
返回值
public class MessageStateResponse
{
public int state; // 0 表示正常, 5表示身份验证错
// 10: 没有找到相应的GroupId
public string subuserid;
public int totalCount; // 总数
public