CTAPIV环迅支付接口..docxVIP

概述本文档主要叙述CT游戏中心服务器与游戏接入商服务器之间的数据通讯协议及规范，双方的软件在此基础上达到数据高性能、高安全性进行交换与共享的目的。[核心接口]表明此接口极为重要，如有任何疑问，请及时与供应商方面联系。随本文档一起还有“demo_xx.txt”，“CasinoLimit_xxxxxx.xlsx”，“CtapiDemoJs”客户端Demo。系统时区：GMT+7系统维护时间：每周二（12：00-13：00）（GMT+7）协议约定及功能接口通讯规范2.1.1数据结构http://host/ctapi?action=actionagent=agentusername=usernameparam=param参数说明：参数类型描述actionString命令标识符agentString代理账号，由供应商提供。区分大小写。usernameString会员账号，长度[1,16]; 只允许数字、字母与@标记符。只能使用小写。paramString其它信息（可选），[]为可以项目2.1.2安全验证安全码供应商提供密文SecurityKey：由供商提供（在demo[xx..xx].txt中）来源检查由接入商提供，一个agent可以对应多个referer（暂时没用）。IP过滤由接入商提供系列IP，IP跟agent进行绑定。测试机不检测IP绑定，正式机强制性检测IP绑定。2.1.3响应规范?xmlversion=1.0? responsecode/codetext/textresult/result/response2.1.4 错误码通常情况下，0 表示没有错误，负数为一般错误，正数为相应操作错误。下表为一般错误表：错误码文本数据描述-1System maintenance系统维护-2Invalid action命令标识符错误-3Invalid arguments请求参数错误-4IP address not allowIP限制-5Invalid username用户名或代理错误-6System error系统错误接口列表及数据约定接入端在请求数据时，需根据接口的不同组织相应的参数为字符串，通过TCP连接发送至服务器端，服务器端通过约定以特定分隔符将字符串解析为对应参数，处理完成后，将结果组织为字符串通过TCP连接发回接入端。在通讯过程中，为保证数据的正确性和提高程序性能，通讯过程中数据类型与字符串之间的转换按下表规范：数据类型描述示例StringUnicode字符串如：hello，abc123Byte可转为标准数字如：-123，9范围：-128~127Integer可转为标准数字如：-123，9范围：-2147483648~2147483647Long可转为标准数字如：-123，4，5099范围：-9223372036854774808~9223372036854774807Double可转为标准浮点数如：-1.23，4，5.09范围：4.9000000e-324~1.797693e+308 Booleanbool值True，FalseDate以yyyy-MM-dd HH:mm:ss 形式的字符串如：2011-01-31 19:25:34为便于客户端与服务器端易于解析数据，以如下分隔符作为数据分隔使用的特殊字符（因此在正常数据内容中，不应包括如下特殊字符）：第一层数据分隔符：|第二层数据分隔符：`第三层数据分隔符：,客户端在接收到来自服务器端的返回数据Data，并转化为字符串时，按接口约定，对该字符串以分隔符从低层至高层拆分，得到最终数据。2.2.1获取会员登录URL[核心接口]操作描述获取供会员登录到供应商进行游戏的URL。首先供应商会检测用户是否存在，若存在，返回登录URL；若不存在，供应商自动创建账号，如果创建成功，返回登录URL，如果创建失败，返回错误原因。注意：调用完此接口，会员需使用返回的URL登录游戏大厅。使用场景用户登录。使用时机，会员登录前。命令标识符1参数及组合格式Lang|Currency|MaxWin|Limit|Token例：cn|RMB|900.0|578,579,580,`589,590,588,587,`594,592,593,591,`710,712,713,714,`-1`1151,1183,1184,1185,`1923,|b69af9287876c8cfc42096be301b233c例：cn|RMB|900.0||b69af9287876c8cfc42096be301b233c参数说明参数类型描述LangString语言(见语言列表)CurrencyString货币(见货币列表)MaxWinDouble该会员的单日最大可赢取金额。（当天12点到第二天12点）注：a)会员最后一笔下注有可能超过最大限