快信科技快信通短彩信直连系统接口说明

1、快信科技快信通短彩信直连系统接口说明 TOC o 1-3 h z u HYPERLINK l _Toc291013899 客户接口说明 PAGEREF _Toc291013899 h 1 HYPERLINK l _Toc291013900 第一章 发送接口 PAGEREF _Toc291013900 h 2 HYPERLINK l _Toc291013901 1.1 请求地址 PAGEREF _Toc291013901 h 2 HYPERLINK l _Toc291013902 1.2参数说明 PAGEREF _Toc291013902 h 2 HYPERLINK l _Toc29101390

2、3 1.3返回值 PAGEREF _Toc291013903 h 3 HYPERLINK l _Toc291013904 第二章 余额及已发送量查询接口 PAGEREF _Toc291013904 h 3 HYPERLINK l _Toc291013905 2.1 请求地址 PAGEREF _Toc291013905 h 3 HYPERLINK l _Toc291013906 2.2参数说明 PAGEREF _Toc291013906 h 4 HYPERLINK l _Toc291013907 2.3返回值 PAGEREF _Toc291013907 h 4 HYPERLINK l _Toc2

3、91013908 第三章 非法关键词查询 PAGEREF _Toc291013908 h 4 HYPERLINK l _Toc291013909 3.1 请求地址 PAGEREF _Toc291013909 h 4 HYPERLINK l _Toc291013910 3.2参数说明 PAGEREF _Toc291013910 h 5 HYPERLINK l _Toc291013911 3.3返回值 PAGEREF _Toc291013911 h 5 HYPERLINK l _Toc291013912 第四章 状态报告接口 PAGEREF _Toc291013912 h 5 HYPERLINK

4、l _Toc291013913 4.1 请求地址 PAGEREF _Toc291013913 h 5 HYPERLINK l _Toc291013914 4.2参数说明 PAGEREF _Toc291013914 h 5 HYPERLINK l _Toc291013915 4.3返回值 PAGEREF _Toc291013915 h 6 HYPERLINK l _Toc291013916 第五章 上行报告接口 PAGEREF _Toc291013916 h 6 HYPERLINK l _Toc291013917 4.1 请求地址 PAGEREF _Toc291013917 h 6 HYPERL

5、INK l _Toc291013918 4.2参数说明 PAGEREF _Toc291013918 h 6 HYPERLINK l _Toc291013919 4.3返回值 PAGEREF _Toc291013919 h 6第一章 发送短信接口1.1 请求地址请求地址是客户接口程序调用时请求的URL地址，使用的是HTTP协议 使用POST方法进行调用，UFT-8编码请求地址是 HYPERLINK /sms.aspx 77:9001/sms.aspxGBK请求地址是 HYPERLINK http:/客户端地址/smsgbk.aspx 77:9001/smsgbk.aspx接口地址通常不会发生什么

6、变化，当发生变化时，我们会通知接口用户1.2参数说明77:9001/sms.aspx(注意:在调用接口时使用x-www-form-urlencoded 编码格式)参数名称字段描述说明userid企业id企业IDaccount发送用户帐号用户帐号，由系统管理员password发送帐号密码用户账号对应的密码mobile全部被叫号码发信发送的目的号码.多个号码之间用半角逗号隔开 content发送内容短信的内容sendTime定时发送时间为空表示立即发送，定时发送格式2010-10-24 09:08:10action发送任务命令设置为固定值sendcheckcontent是否检查内容包含非法关键字当

7、设置为1时表示需要检查，默认0为不检查taskName任务名称本次任务 描述100个字以内 可以为空countnumber号码总数量本次提交的号码总数量mobilenumber手机号码数量本次提交的手机号码数量telephonenumber小灵通或座机号码数本次提交的小灵通或座机号码数数量（如果没有可以不填）提交实例：77:9001sms.aspx?action=send&userid=企业ID&account=账号&password=密码&mobile13527576163&content=内容&sendTime=&taskName=本次任务描述&checkcont

8、ent=1&mobilenumber=10&countnumber=12&telephonenumber=21.3返回码平台处理完用户请求之后，以XML的格式返回。格式如下： Success返回码：成功：Success 失败：Faild ok 返回信息详情见下表 3-剩余余额 13-返回本次任务的序列号ID 2 -提交成功数：当提交成功后返回提交成功短信数返回信息返回信息提示信息描述ok提交成功（注：提交不代表发送成功）用户名或密码不能为空提交的用户名或密码为空发送内容包含sql注入字符包含SQL注入字符用户名或密码错误表示用户名或密码错误短信号码不能为空提交的被叫号码为空短信内容不能为空发送

9、内容为空包含非法字符：表示检查到不允许发送的非法字符对不起，您当前要发送的量大于您当前余额当支付方式为预付费是，检查到账户余额不足其他错误其他数据库操作方面的错误第二章 余额及已发送量查询接口2.1 请求地址请求地址:77:9001/sms.aspx2.2参数说明参数名称字段描述说明userid企业id企业IDaccount用户帐号用户帐号，由系统管理员password帐号密码用户账号对应的密码action任务名称设置为固定的：overage提交实例：77:9001/sms.aspx?action=overage&userid=12&account=账号&password=密码2.3返回码st

10、atus返回状态值：成功返回Success 失败返回：Faildmessage返回信息提示：返回信息详情见下表 payinfo返回支付方式 后付费，预付费overage返回已发送条数sendTotal返回总点数 当支付方式为预付费是返回总充值点数返回信息返回信息提示说明返回空查询成功将返回相应的支付方式、账户使用条数、总充值点数用户名或密码不能为空提交的用户名或密码为空用户名或密码错误表示用户名或密码错误第三章 非法关键词查询3.1 请求地址请求地址：77:9001/sms.aspx3.2参数说明参数名称字段描述说明userid企业id企业IDaccount用户帐号用户帐号，由系统管理员pas

11、sword帐号密码用户账号对应的密码action任务名称设置为固定的：checkkeywordcontent检测发送内容需要发送的内容提交实例：77:9001/sms.aspx?action=checkkeyword&userid=12&account=账号&password=密码&content=内容3.3返回值message返回信息提示：返回信息详情见下表返回信息提示说明用户名或密码不能为空提交的用户名或密码为空用户名或密码错误表示用户名或密码错误包含非法字符检查出来包含非法关键词未包含非法字符未检查出非法关键词第四章 状态报告接口4.1 请求地址请求地址：77:9001/statusAp

12、i.aspx4.2参数说明参数名称字段描述说明userid企业id企业IDaccount用户帐号用户帐号，由系统管理员password帐号密码用户账号对应的密码action任务名称设置为固定的：query提交实例：http:/客户端地址/statusApi.aspx?action=query&userid=12&account=账号&password=密码4.3返回值 121212121212系统里面对应的唯一的mi应的手机号码10状态报告10表示发送成功，20表示发送失败1212某次提交任务的ID2011-12-02 22:12:11发送时间121212121212

13、系统里面对应的唯一的mi应的手机号码10状态报告10表示发送成功，20表示发送失败1212某次提交任务的ID2011-12-02 22:12:11发送时间第五章 上行报告接口4.1 请求地址请求地址：77:9001/callApi.aspx4.2参数说明参数名称字段描述说明userid企业id企业IDaccount用户帐号用户帐号，由系统管理员password帐号密码用户账号对应的密码action任务名称设置为固定的：query提交实例：77:9001/callApi.aspx?action=query&userid=12&account=账号&password=密码4.3返回值 121212121212系统里面对应的唯一的mi机号码