提交发送接口
功能说明:用于提交发送短信的常规方法
请求地址: http://api.51welink.com/EncryptionSubmit/SendSms.ashx
https://api.51welink.com/EncryptionSubmit/SendSms.ashx
参数说明:
参数名 | 参数类型 | 是否必传 | 参数描述 |
---|---|---|---|
AccountId | string | Y | 提交账户 |
AccessKey | string | Y | 加密后的key,加密说明见下方 |
Timestamp | long | Y | Unix时间戳,精确到秒,长度10,不能含有小数及L |
ExtendNo | string | N | 企业代码,不超过15位数字,超出会被截断,数字串 |
Random | Long | Y | 随机数,大于等于1,小于等于9223372036854775807 |
ProductId | int | Y | 产品编码 |
PhoneNos | string | Y | 接收号码间用英文半角逗号“,”隔开,触发产品一次只能提交一个,其他产品一次不能超过10万个号码 |
Content | string | Y | 短信内容:不超过4000字符 |
SendTime | datetime | N | 短信定时时间,格式:yyyy-MM-dd HH:mm:ss |
OutId | string | N | 用户自定义参数,长度≤32,字符串格式 |
AccessKey加密说明:
AccessKey根据公式sha(AccountId={账户名称}&PhoneNos={第一个手机号码}&Password={md5(密码原文+SMmsEncryptKey)}&Random={随机数}&Timestamp={unix时间戳精确到秒})生成。AccessKey串中的参数名称注意大小写和参数顺序,随机数是long类型,数值范围在1 至9223372036854775807之间。
譬如:账户(AccountId):yanfa001,第一个手机号码(PhoneNos):13699999999,密码(Password):yanfa001,固定的加密key:SMmsEncryptKey,随机数(Random):6203922,时间戳(Timestamp):1532928860。
则MD5加密后的密码(password)为:
MD5("yanfa001SMmsEncryptKey")="B54B89712EB997BE99114478E3673E3F",必须为大写。
则凭证(AccessKey)为:
sha256(AccountId=yanfa001&PhoneNos=13699999999&Password=B54B89712EB997BE99114478E3673E3F&Random=6203922&Timestamp=1532928860)="6ba256e4cf24dd386cfa8f6835df7b41e8d6f5c1ccdc1a1062646a05133e0f51"
-
传参示例:
{
AccountId:"yanfa001",
AccessKey:" 6ba256e4cf24dd386cfa8f6835df7b41e8d6f5c1ccdc1a1062646a05133e0f51",
Timestamp:"1532928860",
Random:"6203922",
ExtendNo: "",
ProductId: "1011618",
PhoneNos: "13699999999",
Content:"短信内容【微网通联】",
}
返回值字段说明:
字段名 | 字段类型 | 描述 |
---|---|---|
Result | string | 返回状态值,返回succ标识提交成功 |
Reason | string | 返回状态描述,参见文档错误码-返回值枚举部分 |
MsgId | long | 信息批次号 |
SplitCount | byte | 单条短信内容拆分条数 |
-
返回值示例:
{
"Result":"succ",
"Reason":"提交成功",
"MsgId": 1906051002570082261,
"SplitCount":1
}