飞凡通短信接口.docVIP

客户接口说明 客户接口说明 1 第一章 发送接口 2 1.1 请求地址 2 1.2参数说明 2 1.3返回值 2 第二章 余额及已发送量查询接口 3 2.1 请求地址 3 2.2参数说明 3 2.3返回值 4 第三章 非法关键词查询 4 3.1 请求地址 4 3.2参数说明 4 3.3返回值 4 第四章 状态报告接口 5 4.1 请求地址 5 4.2参数说明 5 4.3返回值 5 4.4错误返回值——状态报告请求错误返回格式及对应值 6 接口说明：客户接口部分提供http url方式的接口，根据客户需求可以提供相应接口，接口编码方式采用统一的UTF-8 第一章 发送接口 1.1 请求地址 请求地址是客户接口程序调用时请求的url地址，采用的是http post 接口，地址是 /sms.aspx 入口地址一般不会发生变化，当发生变化的时候，会通知接口用户 1.2参数说明 /sms.aspx?action=send 参数名称含义说明userid企业id企业IDaccount发送用户帐号用户帐号，由系统管理员password发送帐号密码用户账号对应的密码mobile全部被叫号码发信发送的目的号码.多个号码之间用半角逗号隔开 content发送内容短信的内容sendTime定时发送时间为空表示立即发送，定时发送格式2010-10-24 09:08:10action发送任务命令设置为固定的:sendcheckcontent是否检查内容包含非法 关键字当设置为1时表示需要检查，默认0为不检查taskName任务名称本次任务 描述100个字以内 可以为空countnumber号码总数量本次提交的号码总数量mobilenumber手机号码数量本次提交的手机号码数量telephonenumber小灵通或座机号码数本次提交的小灵通或座机号码数数量例如： /sms.aspx?action=senduserid=12account=账号password=密码mobile=139********,186********content=内容sendTime=taskName=本次任务描述checkcontent=1mobilenumber=10countnumber=12telephonenumber=2 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接口，地址是 /sms.aspx 入口地址一般不会发生变化，当发生变化的时候，会通知接口用户 2.2参数说明 参数名称含义说明userid企业id企业IDaccount用户帐号用户帐号，由系统管理员password帐号密码用户账号对应的密码action任务名称设置为固定的：overage例如： action=overageuserid=12account=账号password=密码 2.3返回值 ?xml version=1.0 encoding=utf-8 ? returnsms returnstatusstatus/returnstatus-------返回状态值：成功返回