亿美软通迅时通短信平台SDK使用说明书.docVIP

亿美软通迅时通短信平台SDK使用说明书 简介： 亿美软通短信SDK由两部分组成：一部分是应用开发程序调用的开发包，另一部分是使用asp开发程序调用的开发包。 亿美sdk开发包使用两种协议与EUCP平台进行交互：一种是亿美私有协议，一种是HTTP1.0协议。而使用前者需要客户的网络状况稳定，它发送时包的大小会比后者小。 其中，asp开发程序调用的开发包是Com组件，它是在应用开发程序包的基础之上开发的。它是提供给asp的专用组件，在使用asp编程时须先注册这个Com组件(regsvr32 X:\XXX\EUCPASPComm.dll)，然后将应用开发程序包动态库文件拷贝到系统目录system或当前文件夹下即可。 SDK包采用标准c++语言，尽量不带有与操作系统或开发工具相关的内容。使用vc++6编写。 SDK又分为单机版和网络版两种，他们的命名是不同的。此文档描述的是所有方法的调用，均可以网络版调用，但有的不能在单机版调用，请注意。 SDK包开发文件有： 1） 基于http协议：HTTPEUCPComm.dll（网络版）、HTTPEUCPCommSingle.dll（单机版），在设置代理时，请设置http协议代理。 2）基于emay协议：EUCPComm.dll（网络版）、EUCPCommSingle.dll（单机版），在设置代理时，请设置SOCK5协议代理。 3）基于asp调用：EUCPASPComm.dll（网络版）、EUCPASPCommSingle.dll（单机版） 无论使用那个开发包，他们调用的接口都是一致的，下面将描述开发包的所有接口使用。 客户在使用SDK开发包时，请先进行测试，再正式接入，如果遇到问题请记录当时的环境，以便我们可以查询问题的原因，及时反馈给我们。 开发包方法描述 下面的方法描述包括所有的方法描述，只能应用在网络版开发包的接口将会标注出来。 Register方法 功能描述：客户端 使用软件序列号进行注册； 函数声明： int __stdcall Register (char* sn, char* pwd,char* EntName,char* LinkMan,char* Phone,char* Mobile,char* Email,char* Fax,char* sAddress,char* Postcode); 参数说明： 参数名称 说明 sn 软件序列号 pwd 密码（6位），必须输入 EntName 企业名称(最多60字节)，必须输入 LinkMan 联系人姓名(最多20字节)，必须输入 Phone 联系电话(最多20字节)，必须输入 Mobile 联系手机(最多15字节)，必须输入 Email 电子邮件(最多60字节)，必须输入 Fax 联系传真(最多20字节)，必须输入 sAddress 公司地址(最多60字节)，必须输入 Postcode 邮政编码(最多6字节)，必须输入 返回值： 返回值 说明 101 网络故障 102 其它故障 0 失败 100 序列号码为空或无效 103 注册企业基本信息失败，当软件注册号码注册成功,但整体还是失败，要重新注册 104 注册信息填写不完整 114 得到标识错误 1 成功 -1 未知故障 GetBalance方法 功能描述：获得帐户当前余额 函数声明： int __stdcall GetBalance(char* sn,char* balance); 参数说明： 参数名称 说明 sn 软件序列号 balance 返回的余额(10个字节),使用时必须先分配内存 返回值： 返回值 说明 101 网络故障 102 其它故障 100 序列号码为空或无效 105 参数balance指针为空 0 失败 1 成功 -1 未知故障 ChargeUp方法 功能描述：短信充值 函数声明： int __stdcall ChargeUp(char* sn,char* acco,char* pass); 参数说明： 参数名称 说明 Sn 软件序列号 Acco 卡号 pass 卡密码 返回值： 返回值 说明 101 网络故障 102 其它故障 100 序列号码为空或无效 106 卡号或密码为空或无效 0 失败 1 成功 -1 未知故障 SendSMS方法 功能描述：发送短消息到EUCP平台； 函数声明： int __stdcall SendSMS(char* sn,char* mn,char* ct); 参数说明： 参数名称 说明 Sn 软件序列号 Mn 手机号码(最多一次发送1000个手机号码,号码间用逗号分隔) Ct 短信内容(最多70个字) 返回值： 返回值 说明 101