短信通短信接口.docVIP

客户接口说明客户接口说明 1 第一章 发送接口 2 1.1 请求地址 2 1.2参数说明 2 1.3返回值 2 第二章 余额及已发送量查询接口 3 2.1 请求地址 3 2.2参数说明 3 2.3返回值 3 第三章 非法关键词查询 4 3.1 请求地址 4 3.2参数说明 4 3.3返回值 4 第四章 状态报告接口 5 4.1 请求地址 5 4.2参数说明 5 4.3返回值 5 4.4错误返回值——状态报告请求错误返回格式及对应值 6 第五章 上行接口 6 5.1 请求地址 6 5.2参数说明 6 5.3返回值 7 5.4错误返回值——回复请求错误返回格式及对应值 7接口说明：客户接口部分提供http url方式的接口，根据客户需求可以提供相应接口，接口编码方式采用统一的UTF-8 第一章 发送接口 1.1 请求地址 请求地址是客户接口程序调用时请求的url地址，采用的是http post 接口，地址是 http://客户端地址/sms.aspx 对应UTF-8 http://客户端地址/smsGBK.aspx 对应GB2312 入口地址一般不会发生变化，当发生变化的时候，会通知接口用户 1.2参数说明 http://客户端地址/sms.aspx http://客户端地址/smsGBK.aspx 参数名称 含义 说明 userid 企业id 企业ID account 发送用户帐号 用户帐号，由系统管理员 password 发送帐号密码 用户账号对应的密码 mobile 全部被叫号码 发信发送的目的号码.多个号码之间用半角逗号隔开 content 发送内容 短信的内容，内容需要UTF-8编码 sendTime 定时发送时间 为空表示立即发送，定时发送格式2010-10-24 09:08:10 action 发送任务命令 设置为固定的:send extno 扩展子号 请先询问配置的通道是否支持扩展子号，如果不支持，请填空。子号只能为数字，且最多5位数。 例如： action=senduserid=12account=账号password=密码mobile=content=内容sendTime=extno= 1.3返回值 在接收到客户端发送的http请求后，返回以xml的方式返回处理结果。格式为： ?xml version=1.0 encoding=utf-8 ? returnsms returnstatusstatus/returnstatus ---------- 返回状态值：成功返回Success 失败返回：Faild messagemessage/message ---------- 返回信息：见下表 remainpoint remainpoint/remainpoint ---------- 返回余额 taskIDtaskID/taskID ----------- 返回本次任务的序列ID successCountssuccessCounts/successCounts --成功短信数：当成功后返回提交成功短信数 /returnsms 返回信息提示 说明 ok 提交成功 用户名或密码不能为空 提交的用户名或密码为空 发送内容包含sql注入字符 包含sql注入字符 用户名或密码错误 表示用户名或密码错误 短信号码不能为空 提交的被叫号码为空 短信内容不能为空 发送内容为空 包含非法字符： 表示检查到不允许发送的非法字符 对不起，您当前要发送的量大于您当前余额 当支付方式为预付费是，检查到账户余额不足 其他错误 其他数据库操作方面的错误 第二章 余额及已发送量查询接口 2.1 请求地址 请求地址是客户接口程序调用的时候请求的url地址，采用的是http post接口，地址是 http://客户端地址/sms.aspx http://客户端地址/smsGBK.aspx 入口地址一般不会发生变化，当发生变化的时候，会通知接口用户 2.2参数说明 参数名称 含义 说明 userid 企业id 企业ID account 用户帐号 用户帐号，由系统管理员 password 帐号密码 用户账号对应的密码 action 任务名称 设置为固定的：overage 例如： action=overageuserid=12account=账号password=密码 2.3返回值 ?xml version=1.0 encoding=utf-8 ? returnsms returnstatusstatus/returnstatus-------返回状态值：成功返回Success 失败返回：Faild messagemessage/message--------------返回信