满意通短信引擎sdk使用手册

【满意通短信引擎SDK使用手册】北京亿美软通科技有限公司[编号]【满意通短信引擎SDK使用手册】API模块开发平台嵌入说明书【北京亿美软通科技有限公司】【作者：顾鹏】【版本号：1.00】【日期：2004-7-29】【满意通短信引擎SDK使用手册】北京亿美软通科技有限公司目录引言文档版本说明第1章基本功能介绍1.1即时发送短信1.2定时发送短信1.3查询单条短信的价格1.4查询余额1.5注册1.6充值1.7接收短信1.8查询满意通版本信息1.9申请转接服务1.10注销转接服务第2章函数说明2.1Delphi版函数说明及实例2.1.1RegistBoth函数2.1.2GetBalance函数2.1.3Chargeup函数2.1.4Sendsms函数2.1.5SendScheduledSMS函数2.1.6GetReplySMS函数2.2通用版函数说明及实例2.2.1VB、VB.net中调用函数形式2.2.1.1RegisterVB函数2.2.1.2GetBalanceVB函数2.2.1.3ChargeUpVB函数2.2.1.4SendSMSVB函数2.2.1.5SendScheSMSVB函数2.2.1.6ReceiveSMSVB函数2.2.1.7GetPriceVB函数2.2.1.8ChangeReciveVB函数2.2.1.9CancelChangeReciveVB函数2.2.2C++,Delphi,C#,ASP中调用函数形式简介2.3JAVA版函数说明及实例2.3.1Client函数2.3.2Regist函数2.3.3GetBalance函数2.3.4ChargUp函数2.3.5SendSMS函数第3章嵌入说明【满意通短信引擎SDK使用手册】北京亿美软通科技有限公司3.1Delphi版嵌入3.2通用版嵌入3.3JAVA版嵌入第4章实例说明4.1Delphi调用Delphi版实例4.2通用版调用实例4.2.1ASP4.2.2VB代码4.2.3Delphi调用通用版代码4.2.4VC代码4.3Java调用实例【满意通短信引擎SDK使用手册】北京亿美软通科技有限公司引言：本技术白皮书编写目的主要为合作伙伴及嵌入服务商提供技术支持的文档说明文档版本说明：版本日期作者说明1.002004-7-29顾鹏【满意通短信引擎SDK使用手册】北京亿美软通科技有限公司第1章基本功能介绍在使用各种功能进行各种测试时(如：注册、发送短信、接收短信等等)，请确认网络处在连通状态，并无网络阻塞情况发生。并注意功能测试流程：Register注册软件→ChargeUp向软件存值→SendSMS发送短信→ReceiveSMS接收短信→GetBalance查询余额。1.1即时发送短信发送短信到一个用户手机中，也可群发至多用户终端；短信内容的长度最大为70个字符，如果短信内容长度大于70个字，需由开发人员对短信内容进行分割处理，例：一条100个字的短信，需将其分为两条(分别为70字、30字)来发送。确保用户准确完整地接收信息。1.2定时发送短信指定日期时间群发或单独发送到指定用户手机中；内容要求同上。1.3查询单条短信的价格可以查询单条短信在通满意平台发送时的价格。1.4查询余额获得当前注册帐户当前余额。1.5注册可以完成软件序列号及完整的企业信息部分的注册功能，并将繁琐的软件注册与企业信息注册两个部分，完整的封装到一个功能模块中，一次完成以上两步操作。1.6充值用户利用充值卡号与密码，进行当前序列号的充值。1.7接收短信下载用户回复的短消息到本地服务器中。1.8申请转接服务申请转接功能后系统将受到的短信直接发送到系统指定的手机中。1.9注销转接服务可以通过注销转接服务，取消绑定的手机号码。第2章函数说明2.1Delphi版函数说明及实例2.1.1RegistBoth函数RegistBoth(softwareSerialNum:PChar;EntName:PChar;LinkMan:PChar;【满意通短信引擎SDK使用手册】北京亿美软通科技有限公司Phone:PChar;Mobile:PChar;Email:PChar;Fax:PChar;sAddress:PChar;Postcode:PChar):boolean;stdcall;函数功能：同时注册软件序列号与企业详细信息的注册；输入参数：软件序列号；企业名称；联系人姓名；联系电话；联系手机；电子邮件；联系传真；公司地址；邮政编码；输出结果：注册成功，函数返回为TRUE；注册失败，函数返回为FALSE；2.1.2GetBalance函数GetBalance(softwareSerialNum:Pchar;outunitPrice:real):real;函数功能：获得帐户当前余额；输入参数：软件序列号，待返回的单位价格实数变量；输出结果：帐号余额，同时通过传入的单位价格实数变量返回单位价格。2.1.3Chargeup函数ChargeUp(softwareSerialNum:PChar;CardNum:PChar;Password:PChar):boolean;函数功能：用充值卡充值；输入参数：软件序列号；卡号；卡密码；输出结果：充值成功，函数返回为TRUE；充值失败，函数返回为FALSE；2.1.4Sendsms函数SendSMS(mobileNums:arrayofPChar;softwareSerialNum:PChar;smsContent:PChar):boolean;函数功能：发送短消息，立即发送方式；输入参数：手机号码数组；软件序列号；短信内容；输出结果：发送短信成功，函数返回为TRUE；发送短信失败，函数返回为FALSE；2.1.5SendScheduledSMS函数SendScheduledSMS(mobileNums:arrayofPChar;softwareSerialNum:PChar;smsContent:PChar;scheduledTime:PChar):boolean;函数功能：按指定时间发送短消息；输入参数：手机号码数组；软件序列号；短信内容；预定发送时间，格式为“yyyy-mm-ddhh:nn:ss”输出结果：发送短信成功，函数返回为TRUE；发送短信失败，函数返回为FALSE；2.1.6GetReplySMS函数GetReplySM(softwareSerialNum:PChar;outSMSTotal:integer):PChar;函数功能：下载用户回复的短消息输入参数：软件序列号；整型变量，用以返回本次下载的短消息数；输出结果：无新短消息，则函数返回值为空，指针为nil；有新短信，函数返回为一个包含全部短信的字符串，格式为“13901001234|短信内容|2003-01-0100:00:01||13901001235|短信内容|2003-01-0100:00:02…”，即每个短信由三部分组成：手机号+短信内容+时间，分隔符为单竖线；各条短信之间用双竖线||【满意通短信引擎SDK使用手册】北京亿美软通科技有限公司分割；同时，本次下载的短信条数通过传入的整型变量带回。2.2通用版函数说明及实例2.2.1VB、VB.net中调用函数形式2.2.1.1RegisterVB函数RegisterVB(软件序列号，企业名称，联系人姓名，联系电话，联系手机，电子邮件，联系传真，公司地址，邮政编码);函数功能：注册软件序列号；输入参数：软件序列号；企业名称；联系人姓名；联系电话；联系手机；电子邮件；联系传真；公司地址；邮政编码输出结果：注册成功，函数返回值：“998”：网络故障“999”：网络故障或其它故障“0”：注册失败,本软件已注册“1”：注册成功其它：未知故障2.2.1.2GetBalanceVB函数GetBalanceVB(软件序列号)函数功能：获得帐户当前余额；输入参数：软件序列号；输出结果：帐号余额。函数返回值：“998”：网络故障“999”：网络故障或其它故障返回其它实数：为帐号余额2.2.1.3ChargeUpVB函数ChargeUpVB(软件序列号，卡号，卡密码):函数功能：用充值卡充值；输入参数：软件序列号；卡号；卡密码；输出结果：充值成功，函数返回值：“998”：网络故障“999”：网络故障或其它故障“0”：充值失败,本存值卡已使用“1”：充值成功其它：未知故障2.2.1.4SendSMSVB函数SendSMSVB(软件序列号,手机号码,短信内容):函数功能：发送短消息，立即发送方式；输入参数：软件序列号；手机号码；短信内容；输出结果：发送短信成功，函数返回值：“998”：网络故障“999”：网络故障或其它故障“0”：发送失败“1”：发送成功【满意通短信引擎SDK使用手册】北京亿美软通科技有限公司其它：未知故障2.2.1.5SendScheSMSVB函数SendScheSMSVB(软件序列号，手机号码，短信内容，预定发送时间):函数功能：按指定时间发送短消息；输入参数：软件序列号；手机号码；短信内容；预定发送时间，格式为“yyyy-mm-ddhh:nn:ss”输出结果：发送短信成功，函数返回值：“998”：网络故障“999”：网络故障或其它故障“0”：发送失败“1”：发送成功其它：未知故障2.2.1.6ReceiveSMSVB函数ReceiveSMSVB(软件序列号):函数功能：下载用户回复的短消息输入参数：软件序列号；输出结果：“997”：没有上行信息“998”：网络故障“999”：网络故障或其它故障其它字符：是用‘|’和‘||’分隔的字符串，需要程序进行解析,格式如:手机号|内容|时间||手机号|内容|时间||...的循环格式。2.2.1.7GetPriceVB函数GetPriceVB(软件序列号):函数功能：通满意平台发送一条短信的价格输入参数：软件序列号；输出结果：“998”：网络故障“999”：网络故障或其它故障其它：通满意平台发送一条短信的价格。2.2.1.8ChangeReciveVB函数ChangeReciveVB(软件序列号，手机号)函数功能：申请转接功能输入参数：软件序列号，手机号；输出结果：“1”：申请成功“2”：申请失败2.2.1.9CancelChangeReciveVB函数CancelChangeReciveVB(软件序列号，手机号)函数功能：注销转接功能输入参数：软件序列号，手机号；输出结果：“1”：注销成功【满意通短信引擎SDK使用手册】北京亿美软通科技有限公司“2”：注销失败2.2.2C++,Delphi,C#,ASP中调用函数形式在C++,Delphi,C#,ASP中调用函数时,函数功能同2.2.1中所介绍的功能、参数、输出结果完全一样，但是函数名略有不同，具体形式如下：Register函数GetBalance函数ChargeUp函数SendSMS函数SendScheSMS函数ReceiveSMS函数GetPrice函数ChangeRecive函数CancelChangeRecive函数2.3JAVA版函数说明及实例2.3.1Client函数publicClient(java.lang.StringserialNumber)构造函数Parameters:serialNumber-软件序列号字符串2.3.2regist函数registpublicbooleanregist()API软件序列号注册方法API只需注册一次。Returns:成功与否的布尔值2.3.3getBalance函数getBalancepublicdoublegetBalance()查询余额Returns:double余额数值2.3.4chargUp函数chargUppublicbooleanchargUp(java.lang.StringcardNo,java.lang.StringcardPass)充值方法，为帐号（序列号）充值。Parameters:cardNo-充值卡卡号cardPass-充值卡密码Returns:【满意通短信引擎SDK使用手册】