平安科技智能投顧接口設計說明書_陸基金 v1.0.5
智能投顧項目
RBPAA接口設計說明書
(for 陸基金)
第1.0.4版
平安科技（深圳）有限公司
創新品牌體驗團隊智能投顧組
二○一七年十月
版本控制信息
版本 日期 擬稿和修改 作者 說明
1.0 2018-4-25 初稿 陳培鎮
?
目錄
1 概述 1
2 接口約定 1
3 接口列表 1
4 接口組成 1
5 接口描述 2
5.1 基金領域 2
5.1.1 基金盤中實時估值接口(F100) 2
5.1.2 基金最新估值查詢接口(F101) 3
5.1.3 基金基礎信息查詢接口(F102) 3
5.1.4 基金歷史凈值查詢接口(F103) 5
6 附錄 5
6.1 CLIENT API 說明（供參考） 5
1 概述
本文目的是定義並描述“智能投顧系統”（以下簡稱“RBPAA系統”）與陸基金的聯機接口規範。
2 接口約定
接口報文編碼格式為“UTF-8”，數據交換格式為JSON，字段類型均為字符串，傳輸方式為 POST，訪問地址為 https://ip:port/app/$tranCode
3 接口列表
接口類型 接口編號 接口名稱 是否令牌認證 是否查詢類
基金領域 F100 基金盤中實時估值接口 否 是
F101 基金最新估值查詢接口 否 是
F102 基金基礎信息查詢接口 否 是
F103 基金歷史凈值查詢接口 否 是
4 接口組成
接口報文由兩部份組成，報文頭和報文體；報文頭說明在該小節定義，報文體根據每個接口編號在各自小節中定義。
數據項 數據域 是否必填 說明
orgId 機構代號 是 310002
tranCode 接口編號 是
version 版本號 是 100
reqChl 請求渠道 是 03
reqTime 請求時間 是 yyyyMMddHHmmssfff
serNum 請求流水號 否 空字符串
token 令牌 否 空字符串
sign 加簽值 是 SHA256withRSA2048
響應報文頭：
數據項 數據域 說明
tranCode 接口編號
respTime 響應時間 yyyyMMddHHmmssfff
respCode 響應碼 00-成功，01-處理中，其他-失敗
sign 加簽值 SHA256withRSA2048
5 接口描述
5.1 基金領域
5.1.1 基金盤中實時估值接口(F100)
接口編號： F100
返回碼說明：詳見報文頭說明。
接口說明：根據時間範圍獲取盤中估值明細。
接口請求：
數據項 數據域 是否必填 說明
valuationDate 估值日期 是 yyyyMMdd
dateType 日期類型 是 D – 自然日
T – 交易日
startTime 起始時間 是 HHmmss
endTime 結束時間 否 HHmmss
如果為空，默認為235959
fundId 基金代碼 是
decimalDigits 估值小數位數 否 默認：4，範圍：4-12
接口返回：
數據項 數據域 說明
fundEvalCount 基金估值明細數量
fundEvalList 基金估值明細列表 List<DtlF1001>
<多筆返回明細>
DtlF1001
數據項 數據域 說明
valuationTime 估值時間 yyyyMMddHHmmss
valuation 基金估值
valuationOrg 估值機構 00-平安科技
報文示例：
請求報文：
{"valuationDate":"20180425","endTime":"153000","fundId":"000008","lang":null,"orgId":"310002","reqChl":"03","reqTime":"20170705090130123","serNum":"1234567890","sign":"QWERTYUIOPQWERTYUIOPQWERTYUIOPSC","startTime":"113000","token":"D688D2555ED94C7285D26BDF4B13D08F","tranCode":"F003","version":"100"}
響應報文：
{"fundEvalCount":"1","fundEvalList":[{"valuation":"1.6424","valuationOrg":"00","valuationTime":"20180425113000"}],"respCode":"00","respMsg":"success","respTime":"20170705090130123","sign":"QWERTYUIOPQWERTYUIOPQWERTYUIOPSC","tranCode":"F003"}
5.1.2 基金最新估值查詢接口(F101)
接口編號： F101
返回碼說明：詳見報文頭說明。
接口說明：根據基金代碼查詢最新的估值信息。
接口請求：
數據項 數據域 是否必填 說明
fundId 基金代碼 是
接口返回：
數據項 數據域 說明
valuationTime 估值時間 yyyyMMddHHmmss
valuation 基金最新估值 精確到4位小數
pchg 漲跌幅 精確到4位小數，單位：%
chg 漲跌值 精確到4位小數
報文示例：
5.1.3 基金基礎信息查詢接口(F102)
接口編號： F102
返回碼說明：詳見報文頭說明。
接口說明：根據基金代碼查詢基金基礎信息，包括基金類型、上一個交易日凈值及漲跌幅，是否支持估值、估值系數等。
接口請求：
數據項 數據域 是否必填 說明
fundId 基金代碼 是
接口返回：
數據項 數據域 說明
fundName 基金名稱
valuationFlag 是否支持估值 0 – 否
1 – 是
rcResult 估值回歸系數
rcDate 估值系數所屬日期 yyyyMMdd
fundType 基金類型 2201 - 股票型
2202 - 混合型
2203 - 債券型
2205 - 貨幣型
2206 - QDII基金
2210 - FOF
2204 - 其他基金
exchange 所屬市場 HS – 滬深市場
earlyOpenTime 早盤開盤時間 HHmmss
earlyCloseTime 早盤閉盤時間 HHmmss
afterOpenTime 午盤開盤時間 HHmmss
afterCloseTime 午盤閉盤時間 HHmmss
prevDate 上一個交易日日期 yyyyMMdd
prevNav 上一個交易日單位凈值
prevNavAcc 上一個交易日累計凈值
prevChg 上一個交易日漲跌值
prevPchg 上一個交易日漲跌幅
pchgM1 近一月漲跌幅
pchgM3 近三月漲跌幅
pchgM6 近半年漲跌幅
pchgY1 近一年漲跌幅
報文示例：
5.1.4 基金歷史凈值查詢接口(F103)
接口編號： F103
返回碼說明：詳見報文頭說明。
接口說明：根據基金代碼和時間範圍獲取基金凈值明細。
接口請求：
數據項 數據域 是否必填 說明
fundId 基金代碼 是
startDate 查詢起始日期 是
endDate 查詢結束日期 否 yyyyMMdd；
如果為空，默認為當前時間
navType 凈值類型 是 U - 單位凈值
A - 累計凈值
接口返回：
數據項 數據域 說明
fundType 基金類型 2201 - 股票型
2202 - 混合型
2203 - 債券型
2205 - 貨幣型
2206 - QDII基金
2210 - FOF
2204 - 其他基金
navCount 凈值明細數量
navList1 貨幣基金凈值明細列表 List<DtlF1031>
navList2 除貨幣外其他基金凈值明細列表 List<DtlF1032>
<多筆返回明細>
DtlF1031
數據項 數據域 說明
navDate 基金查詢時間 yyyyMMdd
prdRate 每萬份收益率
annuRate 7日年化收益率
return1M 近一月回報
return3M 近三月回報
return6M 近六月回報
return1Y 近一年回報
returnYtd 今年以來回報
returnStd 成立以來回報
DtlF1032
數據項 數據域 說明
navDate 基金查詢時間 yyyyMMdd
nav 基金凈值
return1W 近一周回報
return1M 近一月回報
return3M 近三月回報
return6M 近六月回報
return1Y 近一年回報
returnYtd 今年以來回報
returnStd 成立以來回報
navgr1D 當日凈值增長率
chg 漲跌
pchg 漲跌幅
報文示例：
6 附錄
6.1 Client API 說明（供參考）測試環境地址（公網地址）：https://103.28.215.253:10094/app/
示例代碼：
@Test
br/>測試環境地址（公網地址）：https://103.28.215.253:10094/app/
示例代碼：
@Test
// 秘鑰文件
String privateKeyPath = "d:/app/rbpaa/etc/310001/stg-lu-private.key";
String publicKeyPath = "d:/app/rbpaa/etc/310001/stg-rbpaa-public.key";
String algorithm = "SHA256withRSA";
// 請求報文
Req8001 request = new Req8001();
request.setOrgId("310001");
request.setVersion("100");
request.setReqChl("02");
request.setReqTime("20171016120000999");
request.setTranCode("8001");
request.setQueryDate("20171208");
request.setJudgeCycle("005");
try {
// 秘鑰（建議系統啟動時讀取到靜態變量中，只需加載一次）
Object obj = FileUtil.readFileByInputStream(privateKeyPath);
PrivateKey privateKey = (PrivateKey) obj;
obj = FileUtil.readFileByInputStream(publicKeyPath);
PublicKey publicKey = (PublicKey) obj;
// 創建客戶端對象
ApiClient<Req8001, Resp8001> client = new ApiClient<Req8001, Resp8001>(testUrl, algorithm, privateKey, publicKey, 10000);
// 請求服務端並獲取響應對象
Resp8001 response = client.call(request, Resp8001.class, LogEnum.SYSOUT, null);
System.out.println( response.getRespCode() );
} catch(Exception e) {
e.printStackTrace();
}
}API請求依賴包：
後續給出。
平安科技智能投顧接口設計說明書_陸基金 v1.0.5