交易系统API SERVER接口文档

合集下载

NGES交易系统交易API和行情API接口规范

NGES交易系统交易API和行情API接口规范

NGES交易系统交易API和行情API接口规范Version:1.20发布日期:2009年6月20日I.修订记录、核准记录和审核记录修订记录核准记录审核记录文件制作和维护:上海期货交易所技术部;上海期货信息技术有限公司。

目录第一部分、NGES交易系统接口介绍 (1)1.介绍 (2)1.1. 背景 (2)1.2. T RADER API简介 (3)1.3. M DUSER API简介 (3)1.4. T RADER API/M DUSER API发行的平台 (4)1.5. 修改历史 (4)1.5.1. 版本1.20 (4)2.FTD体系结构 (6)2.1. 通讯模式 (6)2.2. 数据流 (8)3.接口模式 (10)3.1. T RADER API接口 (10)3.1.1. 对话流和查询流编程接口 (10)3.1.2. 私有流编程接口 (11)3.1.3. 公共流编程接口 (11)3.2. M DUSER API接口 (11)3.2.1. 对话流编程接口 (12)3.2.2. 行情流编程接口 (13)4.运行模式 (14)4.1. 工作流程 (14)4.1.1. 初始化阶段 (14)4.1.2. 功能调用阶段 (14)4.2. 工作线程 (15)4.3. 会员系统使用T RADER API与交易系统的交互 (16)4.4. 与交易所前置系统的连接 (18)4.5. 本地文件 (19)4.6. 请求/应答日志文件 (19)4.7. 可靠数据流的订阅方式 (19)4.7.1. API维护重传报文的序号 (20)4.7.2. 会员系统维护重传报文的序号 (21)4.8. 心跳机制(H EARTBEAT) (22)4.9. 前置机列表 (23)4.10. 灾备接口 (25)第二部分、TRADERAPI参考手册 (27)1.TRADERAPI接口分类 (28)1.1. 管理接口 (28)1.2. 业务接口 (28)1.3. 当前版本不开放的业务 (30)2.TRADERAPI参考手册 (32)2.1. CS HFE F TDC T RADER S PI接口 (32)2.1.1. OnFrontConnected 方法 (32)2.1.2. OnFrontDisconnected 方法 (32)2.1.3. OnHeartBeatWarning方法 (33)2.1.4. OnPackageStart方法 (33)2.1.5. OnPackageEnd方法 (33)2.1.6. OnRspUserLogin方法 (34)2.1.8. OnRspUserPasswordUpdate 方法 (36)2.1.9. OnRspSubscribeTopic方法 (37)2.1.10. OnRspQryTopic方法 (38)2.1.11. OnRspError 方法 (39)2.1.12. OnRspOrderInsert 方法 (40)2.1.13. OnRspOrderAction 方法 (43)2.1.14. OnRspQuoteInsert 方法 (45)2.1.15. OnRspQuoteAction 方法 (47)2.1.16. OnRspExecOrderInsert 方法 (49)2.1.17. OnRspExecOrderAction 方法 (50)2.1.18. OnRspQryPartAccount 方法 (52)2.1.19. OnRspQryOrder 方法 (54)2.1.20. OnRspQryQuote 方法 (56)2.1.21. OnRspQryTrade 方法 (58)2.1.22. OnRspQryClient 方法 (60)2.1.23. OnRspQryPartPosition 方法 (61)2.1.24. OnRspQryClientPosition 方法 (63)2.1.25. OnRspQryInstrument 方法 (65)2.1.26. OnRspQryInstrumentStatus 方法 (67)2.1.27. OnRspQryBulletin 方法 (68)2.1.28. OnRspQryMarketData 方法 (69)2.1.29. OnRspQryMBLMarketData 方法 (71)2.1.30. OnRspQryHedgeV olume 方法 (72)2.1.31. OnRtnTrade 方法 (73)2.1.32. OnRtnOrder 方法 (75)2.1.33. OnRtnQuote 方法 (77)2.1.34. OnRtnExecOrder 方法 (78)2.1.35. OnRtnInstrumentStatus 方法 (79)2.1.36. OnRtnInsInstrument 方法 (80)2.1.37. OnRtnDelInstrument 方法 (81)2.1.38. OnRtnInsCombinationLeg 方法 (82)2.1.39. OnRtnDelCombinationLeg 方法 (83)2.1.40. OnRtnBulletin 方法 (84)2.1.41. OnRtnAliasDefine 方法 (85)2.1.42. OnRtnFlowMessageCancel方法 (85)2.1.43. OnErrRtnOrderInsert方法 (86)2.1.44. OnErrRtnOrderAction方法 (88)2.1.45. OnErrRtnQuoteInsert方法 (89)2.1.46. OnErrRtnQuoteAction方法 (90)2.1.47. OnErrRtnExecOrderInsert方法 (91)2.1.48. OnErrRtnExecOrderAction方法 (92)2.1.49. OnRspCombOrderInsert方法 (93)2.1.50. OnRspQryCombOrder方法 (95)2.1.51. OnRtnCombOrder方法 (97)2.1.52. OnErrRtnCombOrderInsert方法 (100)2.2. CS HFE F TDC T RADER A PI接口 (102)2.2.1. CreateFtdcTraderApi方法 (102)2.2.2. GetVersion方法 (102)2.2.4. Init 方法 (103)2.2.5. Join 方法 (103)2.2.6. GetTradingDay方法 (103)2.2.7. RegisterSpi 方法 (104)2.2.8. RegisterFront 方法 (104)2.2.9. RegisterNameServer 方法 (104)2.2.10. SetHeartbeatTimeout方法 (105)2.2.11. OpenRequestLog方法 (105)2.2.12. OpenResponseLog方法 (106)2.2.13. SubscribePrivateTopic方法 (106)2.2.14. SubscribePublicTopic方法 (106)2.2.15. SubscribeUserTopic方法 (107)2.2.16. ReqUserLogin 方法 (107)2.2.17. ReqUserLogout 方法 (109)2.2.18. ReqUserPasswordUpdate 方法 (109)2.2.19. ReqSubscribeTopic方法 (110)2.2.20. ReqQryTopic方法 (111)2.2.21. ReqOrderInsert 方法 (112)2.2.22. ReqOrderAction 方法 (113)2.2.23. ReqQuoteInsert 方法 (115)2.2.24. ReqQuoteAction 方法 (116)2.2.25. ReqExecOrderInsert 方法 (117)2.2.26. ReqExecOrderAction 方法 (118)2.2.27. ReqQryPartAccount 方法 (119)2.2.28. ReqQryOrder 方法 (120)2.2.29. ReqQryQuote 方法 (121)2.2.30. ReqQryTrade 方法 (122)2.2.31. ReqQryClient 方法 (123)2.2.32. ReqQryPartPosition 方法 (123)2.2.33. ReqQryClientPosition 方法 (124)2.2.34. ReqQryInstrument 方法 (125)2.2.35. ReqQryInstrumentStatus 方法 (126)2.2.36. ReqQryMarketData 方法 (127)2.2.37. ReqQryBulletin 方法 (127)2.2.38. ReqQryMBLMarketData 方法 (128)2.2.39. ReqQryHedgeV olume 方法 (129)2.2.40. ReqCombOrderInsert方法 (130)2.2.41. ReqQryCombOrder方法 (132)3.TRADERAPI开发示例 (135)第三部分、MDUSERAPI参考手册 (140)1.MDUSERAPI接口分类 (141)1.1. 管理接口 (141)1.2. 业务接口 (141)2.MDUSERAPI参考手册 (142)2.1. CS HFE F TDC M DUSER S PI接口 (142)2.1.1. OnFrontConnected 方法 (142)2.1.2. OnFrontDisconnected 方法 (142)2.1.3. OnHeartBeatWarning方法 (143)2.1.5. OnPackageEnd方法 (143)2.1.6. OnRspUserLogin方法 (144)2.1.7. OnRspUserLogout 方法 (145)2.1.8. OnRspSubscribeTopic方法 (146)2.1.9. OnRspQryTopic方法 (147)2.1.10. OnRspError 方法 (148)2.1.11. OnRtnDepthMarketData 方法 (148)2.2. CS HFE F TDC M DUSER A PI接口 (151)2.2.1. CreateFtdcMduserApi方法 (151)3.1.1. GetVersion方法 (151)2.2.2. Release 方法 (152)2.2.3. Init 方法 (152)2.2.4. Join 方法 (152)2.2.5. GetTradingDay方法 (152)2.2.6. RegisterSpi 方法 (153)2.2.7. RegisterFront 方法 (153)3.1.2. RegisterNameServer 方法 (153)2.2.8. SetHeartbeatTimeout方法 (154)2.2.9. SubscribeMarketDataTopic方法 (154)2.2.10. ReqUserLogin 方法 (155)2.2.11. ReqUserLogout 方法 (156)2.2.12. ReqSubscribeTopic方法 (156)2.2.13. ReqQryTopic方法 (157)3.MDUSERAPI开发示例 (159)第四部分附录 (161)1.错误编码列表 (161)2.枚举值列表 (164)3.数据类型列表 (167)第一部分、NGES交易系统接口介绍本部分主要介绍NGES交易系统的接口,包括:第一章引入NGES交易系统的两个接口,TraderAPI用于会员系统下达交易、控制和查询指令,接收私有流(含报单插入、报单操作响应和成交回报)、公共流(市场控制提示)、响应流和查询流(查询结果);MduserAPI用于会员系统和行情转发商系统接收行情流。

企业付款API接口说明文档_V2 (1)(1)

企业付款API接口说明文档_V2 (1)(1)

5764
32)
是 5K8264ILTKC String(
H16CQ2502SI 32)
8ZNMTM67V
S
是 C380BEC2BF String(
D727A4B684 32)
5133519F3A
D6
是 10000098201 String
41111123456
7890
是 OPEN_ID
String
可 oxTWIuGaIt6 选 gTKsQRLau2
企业付款操作说明信息。必填。
调用接口的机器 Ip 地址
数据示例: Xml 待补充
2.1.4 返回参数
字段名 变量名
必 示例值

返回状态 return_code 是 SUCCESS

类型
String( 16)
返回信息 return_msg 否 签名失败
String( 128)
以下字段在 return_code 为 SUCCESS 的时候有返回
第一步:对参数按照 key=value 的格式,并按照参数名 ASCII 字典序排序如下:
stringA="appid=wxd930ea5d5a258f4f&body=test&device_info=1000&mch_i
d=10000100&nonce_str=ibuaiVcKdpRxkhJA";
String
String
Uint64 _t String String( 32)
如果 user_type 为 WEIXIN_ID,必填
NO_CHECK:不校验真实姓名 FORCE_CHECK:强校验真实姓名(未绑卡 用户会校验失败,无法转账) OPTION_CHECK:针对已绑卡的用户校验 真实姓名(未绑卡用户不校验) 收款用户真实姓名。 如果 check_name 设置为 FORCE_CHECK 或 OPTION_CHECK,则必填用户真实姓名 企业付款金额,单位为分

中国结算系统对外服务接口开发使用文档

中国结算系统对外服务接口开发使用文档

中国结算系统对外服务接口开发使用文档1. 引言本文档旨在指导开发人员使用中国结算系统对外提供的服务接口进行开发。

中国结算系统作为中国境内最大的金融市场中央结算机构,提供了一系列的对外服务接口,用于与系统进行数据交互和业务处理。

2. 系统概述中国结算系统是为了支持各类金融产品的交易和结算而开发的。

该系统提供了一整套的服务接口,包括但不限于用户管理、交易请求、交易撤销、查询服务等。

3. 开发环境准备3.1 开发工具开发人员需要使用现代化的IDE(集成开发环境)来进行开发工作,推荐使用以下开发工具:•Visual Studio Code•Eclipse•IntelliJ IDEA3.2 开发语言和框架中国结算系统对外服务接口使用 RESTful 风格,并且支持多种开发语言,开发人员可以根据自己的喜好和实际需求选择开发语言,常用的开发语言包括:•Java•Python•C#•JavaScript在开发过程中,建议使用现代化的开发框架,以提高开发效率和代码质量。

常用的开发框架包括:•Spring Boot•Django•.NET Core•Express.js3.3 网络环境准备由于中国结算系统是一个云端系统,开发人员需要确保他们的开发环境能够访问到中国结算系统的网络接口。

开发人员可以使用以下方法来测试网络连接:•使用浏览器访问中国结算系统的域名或 IP 地址,确认能够正常连接•使用命令行工具,如 ping 或 curl,测试网络连接的延迟和可用性4. 接口文档4.1 接口概述中国结算系统对外提供的服务接口主要包括以下几类:•用户管理:用于创建、查询和管理系统用户的接口•交易请求:用于发起各类金融产品交易的接口•交易撤销:用于撤销已发起的交易请求的接口•查询服务:用于查询用户、账户、交易等信息的接口4.2 接口规范中国结算系统对外服务接口遵循 RESTful 风格,使用 HTTP 协议进行通信。

开发人员需要使用 HTTP 请求方法来调用接口,并遵循约定的请求参数和响应格式。

证券账户交易FIX_API接口使用规范说明文档

证券账户交易FIX_API接口使用规范说明文档

方正FIX统一金融接入平台接口规范公司名称方正证券股份有限公司文档编号文档名称FIX网关接入说明文档版本 1.0起草起草日期2014年2月14日审批审批日期修订历史版本号日期状态修订人摘要1.02014年2月17日C郭光煜,张昊天增加了使用Demo的附录1.12014年8月7日A郭光煜增加银证转账,资金调拨加密,行情接口状态标识:C–Created A-Added M-Modified D-Deleted说明:该文档所说明的FIX Demo是在Linux Ubuntu12.04版本运行的Eclipse IDE for C/C++ developer环境下运行测试.2目录第一章.FIX网关介绍 (6)第二章.FIX网关接口说明 (7)2.1FIX版本 (7)2.2连接模式 (7)2.3会话控制 (7)2.4帐户模式 (7)第三章.消息格式说明 (8)3.1会话层消息 (8)3.1.1.登录请求(A) (8)3.1.2.登录应答(A) (10)3.1.3.注销请求(5) (11)3.1.4.注销应答(5) (12)3.1.5.心跳包请求(0) (12)3.1.6.心跳包应答(0) (12)3.1.7.会话拒绝(3) (13)3.1.8.重发请求(2) (13)3.1.9.序号重置(4) (14)3.1.10.心跳测试(1) (14)3.2应用层消息 (15)3.2.1.交易类消息 (15)3.2.1.1单笔委托(D) (15)3.2.1.2委托确认,New(8) (19)3.2.1.3委托拒绝,Reject(8) (20)33.2.1.4执行回报(8) (21)3.2.1.5撤单请求(F) (22)3.2.1.6撤单确认,PendingCancel(8) (23)3.2.1.7撤单拒绝(9) (24)3.2.1.8撤单回报,Cancel(8) (25)3.2.1.9委托状态查询请求(H) (26)3.2.1.10委托状态查询应答(8) (27)3.2.1.11组合委托(COD) (29)3.2.1.12组合委托确认,New(8) (32)3.2.1.13组合委托拒绝,Reject(8) (34)3.2.1.14组合执行回报(8) (35)3.2.1.15组合撤单请求(COF) (36)3.2.1.16组合撤单确认,PendingCancel(8) (37)3.2.1.17组合撤单拒绝(9) (39)3.2.1.18组合撤单回报,Cancel(8) (40)3.2.1.19组合委托查询请求(COH) (41)3.2.1.20组合委托查询应答(8) (42)3.2.1.21批量委托(POD) (43)3.2.1.22批量委托确认,New(8) (45)3.2.1.23批量委托拒绝,Reject(8) (46)3.2.1.24批量执行回报(8) (47)3.2.2头寸查询类消息 (49)3.2.2.1资金股份查询(UAN) (49)3.2.2.2资金股份查询回报(UAP) (49)3.2.2.3资金流水查询请求(UAN) (52)43.2.2.4资金流水查询应答(UAP) (52)3.2.2.5银证转账查询请求(UAN) (55)3.2.2.6银证转账查询应答(UAP) (56)3.2.3头寸变更类消息 (58)3.2.3.1银证转账/银行余额业务流程说明 (58)3.2.2.7银证转账/银行余额请求(UAL) (58)3.2.3.2银证转账/银行余额应答(UAM) (60)3.2.3.3资金调拨请求(UAL) (61)3.2.3.4资金调拨应答(UAM) (62)3.2.3.5股份调拨请求(UAL) (63)3.2.3.6股份调拨应答(UAM) (64)附录:测试Demo使用说明 (66)5第一章.FIX网关介绍方正证券的FIX网关主要是为其交易系统提供FIX协议接入。

收银系统开放接口文档v1.2.1

收银系统开放接口文档v1.2.1

收银系统开放接口文档(V1.2.1)目录收银系统开放接口文档 (1)目录 (2)文档版本更新说明 (4)账号说明 (5)1.下单接口 (5)1.1.接口说明: (5)1.2.参数: (6)1.3.返回字段说明: (8)1.4.返回实例结果: (8)2.APP同步返回接口 (9)2.1.接口说明: (9)2.2.参数: (9)2.3.返回字段说明: (10)2.4.返回实例结果: (10)3.异步通知接口 (11)3.1.接口说明: (11)3.2.参数: (11)3.3.返回字段说明: (12)3.4.返回实例结果: (13)4.订单查询接口 (13)4.1.接口说明: (13)4.2.参数: (13)4.3.返回字段说明: (14)4.4.返回实例结果: (17)5.签名机制 (18)5.1.生成签名字符串sign (18)5.2.签名注意事项 (20)6.附录 (20)6.1.交易状态: (20)6.2.请求错误码 (21)文档版本更新说明账号说明账号作用1.下单接口1.1.接口说明:通过WEB、USB、蓝牙、APP等通讯,调起旺POS收银app,并创建订单,收银app将显示支付页面,等待用户支付使用WEB、USB、蓝牙、APP进行下单时,下单接口本身不提供接口访问地址,只提供接口访问参数,调用者在需要使用下单接口时,需使用平台相关api(详见BP服务端开发文档)及近场通讯协议(USB、蓝牙、APP)并传递此接口的所定义的参数(1.2参数),即可调起旺POS收银app支付页面值得注意的是,当使用APP间调用收银下单接口进行下单时,需要APP将1.2参数进行组装成JSON字符串,并以UTF-8编码成byte[]格式,将此byte[]作为参数项传递给sdk的params参数(详见微POS SDK文档),同时,收银app在支付完成后,也会将相应返回字段组装成JSON字符串,并以UTF-8编码成byte[]格式,返回给调用方。

api接口说明文档模板文

api接口说明文档模板文

api接口说明文档模板文api接口说明文档模板1正如在"什么是API"中所说,API函数包含在位于系统目录下的DLL文件中.你可以自己输入API函数的声明,但VB提供了一种更简单的方法,即使用API Text Viewer. 要想在你的工程中声明API函数,只需运行API Text Viewer,打开Win32api.txt(或.MDB如果你已经把它转换成了数据库的话,这样可以加快速度. 使用预定义的常量和类型也是同样的方法. API除了有应用“应用程序接口”的意思外,还特指 API的说明文档,也称为帮助文档。

你将会遇到一些问题假设你想在你的窗体模块中声明一个函数.粘贴然后运行,VB会告诉你:编译错误...Declare 语句不允许作为类或对象模块中的 Public 成员...看起来很糟糕,其实你需要做的只是在声明前面添加一个Private(如 Private Declare Function...).--不要忘了,可是这将使该函数只在该窗体模块可用. 在有些情况下,你会得到"不明确的名称"这样的提示,这是因为函数.常量或其他的什么东西共用了一个名称.由于绝大多数的函数(也可能是全部,我没有验证过)都进行了别名化,亦即意味着你可以通过Alias子句使用其它的而不是他们原有的名称,你只需简单地改变一下函数名称而它仍然可以正常运行.api接口说明文档模板文21、技术优势具有高效率、团结、富有创意的团队,技术实力雄厚,可针对不同层次客户的需求;2、服务优势领先的技术、严密的流程、品牌的保证,为在线交易给予有力的安全保障;庞大的客服体系,为您提供7×24小时不间断的客户服务;3、卡类兑换优势解决客户往返银行汇款的麻烦,提升客户效率,有效增加订单数量。

百汇通具有几十种的卡类兑换方式,与上游运营商合作密切,有大部分运营商充值接口,卡类产品的多样化能够满足所有客户的对于卡类兑换的需求。

API接口文档(精简版)

API接口文档(精简版)

API接口文档(精简版)API接口文档(精简版)1. 简介该文档提供了有关API接口的详细信息,包括接口功能、请求参数、返回结果等内容。

开发人员可以通过此文档了解如何正确调用API接口,并获取所需的数据或实现特定功能。

2. 接口列表以下是可用的API接口列表:- 接口1:功能描述1接口1:功能描述1- 接口2:功能描述2接口2:功能描述2- 接口3:功能描述3接口3:功能描述33. 接口1该接口实现了功能描述1。

以下是该接口的详细信息。

3.1 请求URLGET /api/interface13.2 请求参数该接口不需要任何请求参数。

3.3 返回结果该接口返回以下结果。

{"result": "success","message": "接口调用成功","data": {"field1": "value1","field2": "value2"}}4. 接口2该接口实现了功能描述2。

以下是该接口的详细信息。

4.1 请求URLPOST /api/interface24.2 请求参数该接口需要以下请求参数。

4.3 返回结果该接口返回以下结果。

{"result": "success", "message": "接口调用成功", "data": {"field1": "value1","field2": "value2"}}5. 接口3该接口实现了功能描述3。

以下是该接口的详细信息。

5.1 请求URLPUT /api/interface3/{id}5.2 请求参数该接口需要以下请求参数。

连连支付银行卡代付API商户接口说明书

连连支付银行卡代付API商户接口说明书

String
RSA
String
RSA 加密签名,见安全签名机制
String(32) String(14)
Number(8, 2)
String String String
商户系统唯一标识该代付的流水号 格式:YYYYMMDDH24MISS 14 位数字, 精确到秒 代付金额,单位为 RMB-元。 大于 0 的数字,精确到小数点后两位。 如:49.65 0-对私 1 –对公 对私必须是借记卡 必须
bank_code

开户行所在省 province_code 否
编码
开户行所在市 city_code

编码
开户支行名称 brabank_name 否
订单描述
info_order

代付结果服务 notify_url

器异步通知地

版本号
api_version

大额行号
prcptcd

连连支付 – 银行卡代付 API 商户接口说明书
文档编号 文档版本 保密级别
1.4 保密
连连银通电子支付有限公司
连连支付
银行卡代付 API 商户接口说明书
2014/5/12
连连支付 – 银行卡代付 API 商户接口说明书
目录
目 录 ..............................................................................................................................................1 使用授权声明...................................................................................................................................2 文档修订记录...................................................................................................................................2 1. 文档说明...................................................................................................................................3
  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

目录
1.目的 (2)
2.适用范围 (2)
3.规范性制定标准。

(2)
4.术语、定义和缩略语 (3)
5.交易系统处理流程图 (3)
6.接口定义 (3)
6.1 消息结构 (3)
6.2 URL定义 (4)
6.3 请求信息头 (4)
6.4 请求消息体 (5)
6.5 业务代码列表 (8)
6.6 应答代码列表 (9)
7.样例 (9)
7.1. 请求 (9)
7.2. 应答 (10)
1.目的
规范通过各子系统与交易系统通讯交互,增强交易系统接口的安全性。

特写此文档。

2.适用范围
本规范对与交易系统交互的接口提出规定。

文交所合作伙伴使用。

用于在业务开展中通过交易系统API交互提供技术依据。

3.规范性制定标准。

本接口规范依据下列规范标准而制定:
[1] 接口协议标准
(Q/LEADTONE-WI-RD-35)
4.术语、定义和缩略语
下列术语、定义和缩略语适用于本标准:
词语解释
MD5 message-digest algorithm 5(信息-摘要算法)
DES Data Encryption Standard,
HTTP Hypertext Transfer Protocol(超文本传输协议)
URL Uniform Resource Locators
XML Extensible Mark-up Language
BASE64 一种编码方式,将二进制数据表示为文本以便于传输设计的
5.交易系统处理流程图
6.接口定义
通信接口采用http+post+xml 方式。

以Http为载体,POST作为请求方式,XML作为传输数据格式。

XML包中包括两个部分,消息头和消息体。

客户端使用HTTP POST方法向交易系统发送服务端提供的URL发送请求数据,交易系统服务端作为HTTP服务器返回应答。

6.1 消息结构
所有接口的消息协议数据单元(PDU)由消息头(header)和消息体(body)组成。

消息头和消息体在xml中的表现形式如下:
1)请求head:
最开始是XML版本描述,请求head部分以Top标签起头
<?xml version=”1.0” encoding=”utf-8”?>
< Requet >
<Head>
<Signature>数字签名</ Signature >
<TimeStamp>时间戳</ TimeStamp>
</ Head >
2)请求报文Body部分描述
Body部分以Body标签起头,其中元素标签由各业务端自定义
<Body>
<Trading>
<Subject>业务</Subject>
<DataInfo>
<Val1>参数1</ Val1>
<Val2>参数2</ Val2>
<Val3>参数3</ Val3>
<Valn>参数n</ Valn>
</DataInfo>
</Trading>
</ Body >
</Requet>
3)响应head:
<Response>
< Head >
<ResTime>响应时间</ ResTime >
<ResultCode>响应码</ ResultCode >
</ Head >
< Response >
6.2 URL定义
请求URL部分字段描述:
说明:
mKey: 采用MD5方式对特征字段进行加密而生成,用于服务端验证传递过来的数据的有效性,由业务端自定义加密密钥,请求端密钥修改需要及时通知到服务端。

如:http://localhost:8080/Tradingapi/Tradingsend?mkey=XXXXXXXXXXXXXXXX
6.3 请求信息头
说明:
6.4 请求消息体
说明:
如果计费,对发送方计费。

如果是群发,在状态报告栏里请填写不需要状态报告。

交易系统发送内容子元素DataInfo :
以下是对DataInfo元素的说明
应答消息
Header部分参数描述:
交易系统返回内容子元素DataInfo : 以下是对DataInfo元素的说明
6.5 业务代码列表
6.6 应答代码列表
7.样例
7.1. 请求
<?xml version=’1.0’ encoding=’utf-8’?>
<Request>
< Head >
< Signature>sssssssssssssssss </ Signature>
< TimeStamp >1234567890</ TimeStamp >
< /Head >
<Body>
<Trading>
<Subject> KaiHu </Subject>
<DataInfo>
<PartnerAccountName>x201110001</ PartnerAccountName >
<UserName>testA</ UserName >
<PassWord>123456</Content>
</DataInfo>
</Trading>
</Body>
</Request>
7.2. 应答
<?xml version=”1.0” encoding=”utf-8”?>
<Response>
< Head >
< ResTime >2013-1-18 17:00:00</ ResTime >
< ResultCode >00000</ ResultCode >
<DataInfo>
<Msg>开户成功</ Msg>
</DataInfo>
< /Head >
</Response>。

相关文档
最新文档