立即试用
立即试用 了解详情
立即成为代理
您的当前位置: > 技术支持 >

合作客户

方太
金伯利

联系我们

4006-5006-12
地址:北京市朝阳区建外大街17号28号楼408室 邮编:100022
电话:4006-5006-12

技术支持

和信通短信平台接口文档

接口说明:客户接口部分提供http url方式的接口,根据客户需求可以提供相应接口。

第一章  发送接口

1.1请求地址

请求地址是客户接口程序调用时请求的url地址,采用的是http post 接口,地址是
http://123.57.51.191:8888/v2sms.aspx 对应UTF-8
http://123.57.51.191:8888/v2smsGBK.aspx 对应GB2312
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户

1.2参数说明

http://123.57.51.191:8888/v2sms.aspx
http://123.57.51.191:8888/v2smsGBK.aspx
 

参数名称 含义 说明
userid 企业id 企业ID
timestamp 时间戳 系统当前时间字符串,年月日时分秒,例如:20120701231212
sign 签名 使用 账号+密码+时间戳 生成MD5字符串作为签名。MD5生成32位,且需要小写
例如:
账号是test
密码是mima
时间戳是20120701231212
就需要用testmima20120701231212
来生成MD5的签名,生成的签名为5cc68982f55ac74348e3d819f868fbe1
mobile 全部被叫号码 发信发送的目的号码.多个号码之间用半角逗号隔开 
content 发送内容 短信的内容,内容需要UTF-8编码
sendTime 定时发送时间 为空表示立即发送,定时发送格式2010-10-24 09:08:10
action 发送任务命令 设置为固定的:send
extno 扩展子号 请先询问配置的通道是否支持扩展子号,如果不支持,请填空。子号只能为数字,且最多10位数。
例如:
action=send&userid=12×tamp=20120701231212&sign =5cc68982f55ac74348e3d819f868fbe1&mobile=
13911776674,13911776674&content=内容&sendTime=&extno=

1.3返回值

在接收到客户端发送的http请求后,返回以xml的方式返回处理结果。格式为:
 
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<returnstatus>status</returnstatus> ---------- 返回状态值:成功返回Success 失败返回:Faild
<message>message</message> ---------- 返回信息:见下表
<remainpoint> remainpoint</remainpoint> ---------- 返回余额
 
<taskID>taskID</taskID>  -----------  返回本次任务的序列ID
<successCounts>successCounts</successCounts> --成功短信数:当成功后返回提交成功短信数
</returnsms>
 

返回信息提示 说明
ok 提交成功
用户名或密码不能为空 提交的用户名或密码为空
发送内容包含sql注入字符 包含sql注入字符
用户名或密码错误 表示用户名或密码错误
短信号码不能为空 提交的被叫号码为空
短信内容不能为空 发送内容为空
包含非法字符: 表示检查到不允许发送的非法字符
对不起,您当前要发送的量大于您当前余额 当支付方式为预付费是,检查到账户余额不足
其他错误 其他数据库操作方面的错误
 

第二章 余额及已发送量查询接口

2.1请求地址

请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口,地址是
http://123.57.51.191:8888/v2sms.aspx
http://123.57.51.191:8888/v2smsGBK.aspx
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户

2.2参数说明

参数名称 含义 说明
userid 企业id 企业ID
timestamp 时间戳 系统当前时间字符串,年月日时分秒,例如:20120701231212
sign 签名 使用 账号+密码+时间戳 生成MD5字符串作为签名。MD5生成32位,且需要小写
例如:
账号是test
密码是mima
时间戳是20120701231212
就需要用testmima20120701231212
来生成MD5的签名,生成的签名为5cc68982f55ac74348e3d819f868fbe1
action 任务名称 设置为固定的:overage
例如:
action=overage&userid=12×tamp=20120701231212&sign =5cc68982f55ac74348e3d819f868fbe1

2.3返回值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<returnstatus>status</returnstatus>-------返回状态值:成功返回Sucess (注意:此处是Sucess,和其它接口返回的Success不同)失败返回:Faild
<message>message</message>--------------返回信息提示:见下表
<payinfo>payinfo</payinfo>--------------返回支付方式  后付费,预付费
<overage>overage</overage>-------------返回余额
<sendTotal>sendTotal</sendTotal>----返回总点数  当支付方式为预付费是返回总充值点数
</returnsms>
 

返回信息提示 说明
返回空 查询成功
将返回相应的支付方式、账户使用条数、总充值点数
用户名或密码不能为空 提交的用户名或密码为空
用户名或密码错误 表示用户名或密码错误
 
 

第三章 非法关键词查询

3.1请求地址

请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口,地址是
http://123.57.51.191:8888/v2sms.aspx
http://123.57.51.191:8888/v2smsGBK.aspx
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户

3.2参数说明

参数名称 含义 说明
userid 企业id 企业ID
timestamp 时间戳 系统当前时间字符串,年月日时分秒,例如:20120701231212
sign 签名 使用 账号+密码+时间戳 生成MD5字符串作为签名。MD5生成32位,且需要小写
例如:
账号是test
密码是mima
时间戳是20120701231212
就需要用testmima20120701231212
来生成MD5的签名,生成的签名为5cc68982f55ac74348e3d819f868fbe1
action 任务名称 设置为固定的:checkkeyword
content 检测发送内容 需要发送的内容
例如:
action=checkkeyword&userid=12×tamp=20120701231212&sign =5cc68982f55ac74348e3d819f868fbe1&content=内容

3.3返回值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<message>message</message>--------------返回信息提示:见下表
</returnsms>
 

返回信息提示 说明
用户名或密码不能为空 提交的用户名或密码为空
用户名或密码错误 表示用户名或密码错误
包含非法字符 检查出来包含非法关键词
没有包含屏蔽词 未检查出非法关键词
 
 
 

第四章 状态报告接口

4.1请求地址

请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口,地址是
http://123.57.51.191:8888/v2statusApi.aspx
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户
注意:相同的状态报告,只能获取一次。

4.2参数说明

参数名称 含义 说明
userid 企业id 企业ID
timestamp 时间戳 系统当前时间字符串,年月日时分秒,例如:20120701231212
sign 签名 使用 账号+密码+时间戳 生成MD5字符串作为签名。MD5生成32位,且需要小写
例如:
账号是test
密码是mima
时间戳是20120701231212
就需要用testmima20120701231212
来生成MD5的签名,生成的签名为5cc68982f55ac74348e3d819f868fbe1
statusNum 每次取得号码数 必须为数字,默认4000,可不填
action 任务名称 设置为固定的:query
例如:
action=query&userid=12×tamp=20120701231212&sign =5cc68982f55ac74348e3d819f868fbe1

4.3返回值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<statusbox>
<mobile>13911776674</mobile>-------------对应的手机号码
<taskid>1212</taskid>-------------同一批任务ID
<status>10</status>---------状态报告----10:发送成功,20:发送失败
<receivetime>2011-12-02 22:12:11</receivetime>-------------接收时间
<errorcode>DELIVRD</errorcode>-上级网关返回值,不同网关返回值不同,仅作为参考
<extno>01</extno>--子号,即自定义扩展号
</statusbox>
<statusbox>
<mobile>13911776674</mobile>
<taskid>1212</taskid>
<status>20</status>
<receivetime>2011-12-02 22:12:11</receivetime>
<errorcode>2</errorcode>
<extno></extno>
</statusbox>
</returnsms>

4.4错误返回值——状态报告请求错误返回格式及对应值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<errorstatus>
<error>1</error>-------------错误码
<remark>用户名或密码不能为空</remark>-------------错误描述
</errorstatus>
</returnsms>
1:用户名或密码不能为空
2:用户名或密码错误
3:该用户不允许查看状态报告
4:参数不正确
 
 
 
 
 
 
 

第五章 上行接口

5.1请求地址

请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口,地址是
http://123.57.51.191:8888/v2callApi.aspx
入口地址一般不会发生变化,当发生变化的时候,会通知接口用户
注意:相同的上行回复,只能获取一次。
 

5.2参数说明

参数名称 含义 说明
userid 企业id 企业ID
timestamp 时间戳 系统当前时间字符串,年月日时分秒,例如:20120701231212
sign 签名 使用 账号+密码+时间戳 生成MD5字符串作为签名。MD5生成32位,且需要小写
例如:
账号是test
密码是mima
时间戳是20120701231212
就需要用testmima20120701231212
来生成MD5的签名,生成的签名为5cc68982f55ac74348e3d819f868fbe1
action 任务名称 设置为固定的:query
例如:
action=query&userid=12×tamp=20120701231212&sign =5cc68982f55ac74348e3d819f868fbe1

5.3返回值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<callbox>
<mobile>13911776674</mobile>-------------对应的手机号码
<taskid>1212</taskid>-------------同一批任务ID
<content>你好,我不需要</content>---------上行内容
<receivetime>2011-12-02 22:12:11</receivetime>-------------接收时间
<extno>01</extno>----子号,即自定义扩展号
</callbox>
<callbox>
<mobile>13911776674</mobile>
<taskid>1212</taskid>
<content>你好,本次活动路线是怎么的</content>
<receivetime>2011-12-02 22:12:11</receivetime>
<extno>01</extno>
</callbox>
</returnsms>

5.4错误返回值——回复请求错误返回格式及对应值

<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<errorstatus>
<error>1</error>-------------错误码
<remark>用户名或密码不能为空</remark>-------------错误描述
</errorstatus>
</returnsms>
1:用户名或密码不能为空
2:用户名或密码错误
3:该用户不允许查看状态报告
4:参数不正确
 
 

技术支持 (下载技术文档)
  • 服务咨询 4006-5006-12
  • 一对一贵宾级服务
  • 7X24小时技术保障
售前客服
4006-5006-12 服务时间:周一到周五 9:00-17:30
  • 在线试用
  • 我要咨询
  • 售后服务
精准短信营销服务商、群发短信广告、群发彩信广告、106短信通知平台、106验证码短信平台!
版权所有:美高梅手机客户端:群发短信|群发短信平台|短信平台|群发短信软件|彩信群发平台|106短信平台
【增值电信业务经营许可证】编号:京B2-20110027
公司地址:北京市朝阳区建外大街17号28号楼408室 邮编:100022
座机:010-65686118;总机:4006-5006-12 | 备案号:京ICP备11005723号-2
[免费试用] [联系我们]

网站优化支持:云优化 友情链接:木门厂家 上海展台搭建 厨房设备 翻译公司 线上推广 呼叫中心系统 二手钢琴价格 气体检测仪 心理专家 上海会展公司 群发短信 液压千斤顶 翻译公司 北京公司注销 护坡石 垃圾车 回收烟酒 宣传片制作公司 公司注册 北京注册公司 木屋厂家 广州搬家公司 录播 北京公司注册 版权律师 短信群发 塑料周转箱 特教设备 商标注册代理 北京网站建设 石家庄租车 柴油发电机

XML 地图 | Sitemap 地图