客户接口说明.docx

客户接口说明 TOC \o 1-5 \h \z \o Current Document 客户接口说明 1 第一章发送接口 2 1.1诺求地址 2 \o Current Document 1.2参数说明 2 \o Current Document 1.3返回值 2 第?.章余额及已发送量査询接口 3 2.1请求地址 3 \o Current Document 2.2参数说明 3 \o Current Document 2.3返回值 3 第三章非法关键词査询 4 3.1请求地址 4 \o Current Document 3.2参数说明 4 \o Current Document 3.3返回值 4 第四章状态报吿接II 5 4.1请求地址 5 \o Current Document 4.2参数说明 5 \o Current Document 4.3返回值 5 \o Current Document 4.4错误返M值——状态报告请求错误返求格式返回应式 6 第五章上行接口 6 5.1请求地址 6 \o Current Document 5.2参数说明 6 5.3返回值 7 5.4错误返M值——回史请求错误返回格式及对应值 7 第六章附加说明 8 接「1说明；客户接口部分提供hitp url方式的接口.根据客户需求可以提供相应接口，接口 编码方式采用统一的UTF-8 第一章发送接口 1.1请求地址 请求地址是客户接口程序调用时请求的丽地址.采用的是http post接口，地址是 :8888/sms. aspx 对应 UTF-8 :8888/smsGBK. aspx 对应 GB2312 入口地址--般不会发生变化.当发生变化的时候，会通知接口用户 1.2参数说明 rr1.3 rr 1.3返回值 :8888/sms.aspx :8888/smsGBK.aspx 参数名称 含义 说明 userid 企业id 企业ID account 发送用户帐号 用户帐号，由系统管理员 password 发送帐号密码 用户账号对应的密码 mobile 全部被叫号码 发信发送的目的号码.多个号码之间用半角逗 号隔开 content 发送内容 短信的内容，内容需要UTF-8编码 scndTime 定时发送时间 为空表示立即发送，定时发送格式2010-10-24 09:08:10 action 发送任务命令 设置为固定的:send extno 扩展子号 清先询问配置的通道是否支持扩展子号，如果 不支持，请填空。子号只能为数字?且最多5 位数。 例如： action=senduscrid= 12account=账号 password=密码 mobiic=.contcnt=内容 scndTimc=extno= 在接收到客户端发送的hup请求后.返回以xml的方式返回处理结果。格式为： ?xml version=HI.OMencoding=Mutf-8w ? retumsms retumstatusstatus/returnslatus 返回状态值:成功返回 Success 失败返回：Faild messageniessage/niessage 返回信 息: 见下表 remainpoint rcniainpoint/rcmainpoint 返 回余额 lask!Dlask!D/laskID返回本次任务的序列ID lask!Dlask!D/laskID 返回本次任务的序列ID successCountssucccssCounts/successCounts -成功短信数：当成功后返回提交成功短信 数 /returnsnis 返回信息提示 说明 ok 提交成功 用户名或密码不能为空 提交的用户名或密码为空 发送内容包含sql注入字符 包含sql注入字符 用户名或密码错误 表示用户名或密码错误 短信号码不能为空 提交的被叫号码为空 短信内容不能为空 发送内容为空 包含非法字符： 表示检査到不允许发送的非法字符 对不起，您与前要发送的量大于您当前余额 当支付方式为预付费是，检査到账户余额不足 其他緒误 其他数据库操作方面的错误 第二章余额及已发送量查询接口 2.1请求地址 请求地址是客户接口程序调用的时候请求的url地址，采用的是http post接口,地址是 :8888/sms.aspx :8888/smsGBK.aspx 入口地址一般不会发生变化，当发生变化的时候，会通知接口用户 2.2参数说明 参数名称 含义 说明 userid 企业id 1 企业ID account 用户帐号 用户帐号，由系统管理员 password 帐号密码 用户账号对应的密码 action 任务名称 设置为固定的：overage 例如： actio