企业信使运营管理平台API接口调用说明教学文稿.docVIP

企业信使运营管理平台API接口说明 TOC \o 1-3 \h \z \u 13647 客户接口说明 1 1074 第一章 发送接口 2 15637 1.1 请求地址 2 12275 1.2参数说明 2 5175 1.3返回值 3 12422 第二章 余额及已发送量查询接口 3 16695 2.1 请求地址 3 23419 2.2参数说明 4 28697 2.3返回值 4 28338 第三章 非法关键词查询 4 18815 3.1 请求地址 4 20860 3.2参数说明 5 23498 3.3返回值 5 21444 第四章 状态报告接口 5 28181 4.1 请求地址 5 911 4.2参数说明 5 5196 4.3返回值 6 13129 4.4错误返回值——状态报告请求错误返回格式及对应值 6 接口说明：客户接口部分提供http url方式的接口，根据客户需求可以提供相应接口，接口编码方式采用统一的UTF-8 接口账户请登录我们网站注册 http:// 接口账户必须是英文格式 不支持中文名！ 企业ID 在登录系统后查看 我的信息！ 第一章 发送接口 1.1 请求地址 请求地址是客户接口程序调用时请求的url地址，采用的是http post 接口，地址是 /sms.aspx 入口地址一般不会发生变化，当发生变化的时候，会通知接口用户 1.2参数说明 /sms.aspx?action=send 参数名称 含义 说明 userid 企业id 企业ID account 发送用户帐号 用户帐号，由系统管理员 password 发送帐号密码 用户账号对应的密码 mobile 全部被叫号码 发信发送的目的号码.多个号码之间用半角逗号隔开 content 发送内容 短信的内容 sendTime 定时发送时间 为空表示立即发送，定时发送格式2010-10-24 09:08:10 action 发送任务命令 设置为固定的:send checkcontent 是否检查内容包含非法关键字 当设置为1时表示需要检查，默认0为不检查 例如： action=senduserid=12account=账号password=密码mobile15265260972content=内容sendTime=checkcontent=1 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 企业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返回信息提示：见下表 payinfopayinfo/payinfo