短信接口请求URL

http://ip:port/sms/v2/std/single_send

短信接口请求方式

POST

梦网云通讯平台单条短信发送接口请求参数说明

参数

类型

是否必须

描述

示例

userid

string

用户账号:长度最大6字符,统一大写

示例:J10003

pwd

string

用户密码:定长小写32位字符。密码规则详见“3.1 鉴权规则

示例:

密码明文模式:111111

密码加密模式:

账号:J10003

密码:111111

固定字符串:00000000

时间戳:0803192020

MD5加密之前的对应字符串:

J10003000000001111110803192020

MD5加密之后的密码字符串:

26dad7f364507df18f3841cc9c4ff94d

mobile

string

短信接收的手机号:只能填一个手机号。 号码规则详见“3.2 手机号码规则

示例:13800138000

content

string

短信内容:最大支持350个字,一个字母或一个汉字都视为一个字

编码方式:
urlencodeGBK明文)

示例:

短信内容:“欢迎使用本接口”

短信内容进行urlencode编码后:

%b2%e2%ca%d4%b6%cc%d0%c5

timestamp

string

时间戳:24小时制格式:MMDDHHMMSS,即月日时分秒,定长10,月、日、时、分、秒每段不足2位时左补0,密码选择MD5加密方式时必填该参数,密码选择明文方式时则不用填写

示例:0803192020

svrtype

string

业务类型:最大可支持10个长度的英文字母、数字组合的字符串

示例:SMS001

exno

string

扩展号:长度不能超过6位,注意通道号+扩展号的总长度不能超过20,若超出则exno无效,如不需要扩展号则不用提交此字段或填空

示例:0006

custid

string

用户自定义流水号:该条短信在您业务系统内的ID,比如订单号或者短信发送记录的流水号。填写后发送状态返回值内将包含用户自定义流水号。

最大可支持64位的ASCII字符串:字母、数字、下划线、减号,如不需要则不用提交此字段或填空

示例:b3d0a2783d31b21b8573

exdata

string

自定义扩展数据:额外提供的最大64个长度的ASCII字符串:字母、数字、下划线、减号,作为自定义扩展数据,填写后,状态报告返回时将会包含这部分数据,如不需要则不用提交此字段或填空

 

表1-1

短信验证码返回参数说明

参数

    类型

描述

示例

result

int

短信发送请求处理结果:

0:成功

0:失败,详见4 错误代码表

示例:0

msgid

long

(64)

平台流水号:非064位整型,对应JavaC#long,不可用int解析。result0时,msgid0

示例:9223372036854775808

注意:msgid允许出现负数

custid

string

用户自定义流水号:默认与请求报文中的custid保持一致,若请求报文中没有custid参数或值为空,则返回网关生成的平台流水号

result0时,custid为空

示例:b3d0a2783d31b21b8573

表1-2

10-18 06:44