X-One 系统看穿式监管 V1.6.3 版本客户端及 API 使用相关说明
X-One V1.6.3 版本向下兼容旧版 API(1.6.1 及 1.5.3 版本 ) 及客户端, 对应的终端编号为 dfitc_compatible_1.6.1, 可以在授权码管理菜单界面看到其对应的授权码信息 如果删除了该条终端编号的记录或者修改了该授权码状态为禁止准入, 使用旧版 API 及客户端的客户将无法登录 1 客户端登录 根据监控中心要求, 需采集客户交易终端信息,V1.6.3 版本客户 端需 以管理员身份运行 1.1 XSpeed 客户端登录 当前 XSpeed 客户端已经内置 AppID, 无需投资者做任何修改, 其对应的终端编号为 dfitc_xspeed_1.6.3, 可以在授权码管理菜单界面看到其对应的授权码信息 如果删除了该条终端编号的记录或者修改了该授权码状态为禁止准入, 则会影响后续 XSpeed 客户端的登录 1.2 XOne 客户端登录 当前 XOne 客户端已经内置 AppID, 无需投资者做任何修改, 其对应的终端编号为 dfitc_xone_1.6.3, 可以在授权码管理菜单界面看到其对应的授权码信息 如果删除了该条终端编号的记录或者修改了该授权码状态为禁止准入, 则会影响后续 XOne 客户端的登录
2 API 登录 根据监控中心要求, 需采集客户交易终端信息,V1.6.3 版本 API 所在目录需要 Root 运行权限 2.1 采集库 XONE 版本包中发布有采集库, 在 x1_server_v1.6.3.x/api/collect 目录下 采集库主要是提供给中继代理软件商使用, 使用采集库采集其客户终端的指标信息后, 再上报 XONE 柜台系统 采集库 collect 目录下包含 include 和 lib 两个文件夹 : include 文件夹 lib 文件夹 采集库头文件 采集库库文件 其中 lib 目录下包含 linux 和 windows 两个文件夹 : linux 文件夹 windows 文件夹 存放 linux 采集库 存放 windows 采集库 其中 windows 目录下包含 x86 和 x64 两个文件夹 : x86 文件夹 x64 文件夹 存放 win32 系统采集库 存放 win64 系统采集库 /** 采集库中获取采集信息的方法 * @brief 获取采集信息密文
* {@param[out] <out>< 用于存放采集信息密文 >} * {@param[in] <size>< 输出缓冲区的最大值, 目前采集信息密文最大长度不会超过 1024>} * {@param[out] <real_size>< 采集信息密文的实际长度 >} * {@retval <int>} * {@return <0 表示正常 ; -1 表示参数错误 ; -2 表示权限不足 ; 正数表示 out 大小应大于此值 >} */ int DfitcGetSysInfo(char* out, int size, int* real_size); 获取采集库当前版本号的方法 /** * @brief 获取穿透监管采集库版本号 * {@retval <const char *>} * {@return < 获取穿透监管采集库版本号 >} */ const char* GetDfitcVersion(); 2.2 XSpeed API 登录 XSpeed API 登录结构体 DFITCUserLoginField 新增两个字段 数据类型字段字段注释 DFITCAppIDType appid; // 终端编号
DFITCAuthCodeType authcode; // 授权码 客户使用 XSpeed API 登录 XONE 柜台系统时需要填入终端编号和 对应的授权码 新增补充采集信息上报接口 ReqSubmitUserSystemInfo int ReqSubmitUserSystemInfo (struct DFITCSubmitUserSystemInfoField * pusersystemdata) ; 直连模式下, 不需要用户上报采集信息 ; 中继模式下, 由中继代理软件使用该接口上报其下客户的终端采 集信息, 其中客户终端采集信息可通过在客户终端中调用采集库获取 到 采集信息上报结构体如下 : DFITCRequestIDType lrequestid 请求 ID DFITCAccountIDType accountid 资金账户 ID DFITCAppIDType appid AppID 明文, 连接中继代理的客户终端的编号 DFITCAppIDType relayappid RelayAppID 明文, 中继代理软件的终端编号 ( 已经录入 XONE 柜台系统中 ) DFITCRemoteIPType remoteip 终端公网 IP
DFITCRemotePortType remoteport 终端公网 port DFITCRemoteLoginTimeType logintime 登录时间, 格式 2018-05-01 09:00:00 DFITCSystemInfoType systeminfo 终端采集信息密文 ( 通过采集库接口获取 ) DFITCSystemInfoLenType systeminfolen 终端采集信息密文长度 ( 通过采集库接口获取后返回的数据的实际长度 ) 2.3 XOne API 登录 XOne API 登录结构体 CX1FtdcReqUserLoginField 新增两个字段 数据类型字段字段注释 TX1FtdcAppIDType AppID; // 终端编号 TX1FtdcAuthCodeType AuthCode; // 授权码 客户使用 XOne API 登录 XONE 柜台系统时需要填入终端编号和对 应的授权码 XONE API 采集信息上报接口 :
Int ReqSubmitUserSystemInfo (struct CX1FtdcReqSubmitUserSystemInfoField * pusersystemdata) ; XONE API 采集信息上报结构体如下 : TX1FtdcRequestIDType RequestID; 请求 ID TX1FtdcAccountIDType AccountID; 资金账户 ID TX1FtdcAppIDType AppID; AppID 明文 TX1FtdcAppIDType RelayAppID; RelayAppID 明文 TX1FtdcRemoteIPType RemoteIP; 终端公网 IP TX1FtdcRemotePortType RemotePort; 终端公网 port TX1FtdcRemoteLoginTimeTy pe LoginTime; 登录时间 TX1FtdcSystemInfoType EncryptSystemInfo; 终端采集信息密 文 TX1FtdcSystemInfoLenType EncryptSystemInfoLe n; 终端采集信息密 文长度