投資理財

Open Banking_Investment 1.0.0

取得Open Banking 產品相關資訊

production
development
https://openapi-sandbox.esunbank.com.tw/sandbox

路徑

/{productType}/list

get /{productType}/list
wealthInvestment

投資理財金融商品列表

查詢投資理財之金融商品名稱列表, key value對應, 不同類型商品列表, key是中文名, value是查詢用參數

X-STAN
header 中的必要項目
string

客戶端發送Request記錄的處理序號

{
    "default": "1234567",
    "pattern": "^[0-9]{7}$"
}
X-DestinationId
header 中的必要項目
string

TXN destination institute ID, 指參加單位代號, 例如：銀行代號

{
    "default": "8080000",
    "pattern": "^[0-9]{7}$"
}
X-ClientId
header 中的必要項目
string

client App 註冊於Open Banking GateWay的id

{
    "default": "user"
}
X-TxnInitDateTime
header 中的必要項目
string

TXN initiate date and time, 交易發起日期時間, 格式yyyyMMddhhmmss

{
    "default": "20200702000000",
    "pattern": "^[0-9]{14}$"
}
productType
path 中的必要項目
string

投資理財金融商品類型, ex:基金用fund

{
    "enum": [
        "fund"
    ]
}
Accept
header中的選用項目
string
application/json
200

回應成功

appWealthProductList
範例要求
範例回應
回應資料僅供測試使用，如需串接真實資料，請至首頁留下聯繫資訊，將有專人與您聯繫。
GET https://openapi-sandbox.esunbank.com.tw/sandbox/openAPI/v1.0.0/wealth/{productType}/list
嘗試此作業
https://openapi-sandbox.esunbank.com.tw/sandbox/openAPI/v1.0.0/wealth/{productType}/list
accept
X-STAN
X-DestinationId
X-ClientId
X-TxnInitDateTime
productType

/funds

get /funds
wealthInvestment

基金投資商品查詢

依查詢投資理財之金融商品名稱列表內的名稱所對應的value去查詢

X-STAN
header 中的必要項目
string

客戶端發送Request記錄的處理序號

{
    "default": "1234567",
    "pattern": "^[0-9]{7}$"
}
X-DestinationId
header 中的必要項目
string

TXN destination institute ID, 指參加單位代號, 例如：銀行代號

{
    "default": "8080000",
    "pattern": "^[0-9]{7}$"
}
X-ClientId
header 中的必要項目
string

client App 註冊於Open Banking GateWay的id

{
    "default": "user"
}
X-TxnInitDateTime
header 中的必要項目
string

TXN initiate date and time, 交易發起日期時間, 格式yyyyMMddhhmmss

{
    "default": "20200702000000",
    "pattern": "^[0-9]{14}$"
}
fundProductValues
query 中的必要項目
array

基金產品productList名稱列表所對應的value, 用逗號區隔多種名稱的value

{
    "items": {
        "type": "string"
    }
}
Accept
header中的選用項目
string
application/json
200

回應成功

appFund
範例要求
範例回應
回應資料僅供測試使用，如需串接真實資料，請至首頁留下聯繫資訊，將有專人與您聯繫。
GET https://openapi-sandbox.esunbank.com.tw/sandbox/openAPI/v1.0.0/wealth/funds
嘗試此作業
https://openapi-sandbox.esunbank.com.tw/sandbox/openAPI/v1.0.0/wealth/funds
accept
X-STAN
X-DestinationId
X-ClientId
X-TxnInitDateTime
fundProductValues

定義

正確查詢參數列表資訊回應的資料模型

{
    "type": "object",
    "properties": {
        "appRepBody": {
            "$ref": "#\/definitions\/wealthProductList"
        },
        "appRepExtension": {
            "description": "擴充欄位，可以任意key value pair",
            "type": "object",
            "additionalProperties": {
                "type": "string"
            }
        }
    }
}

投資理財之金融商品列表, ex:key是中文名, value是查詢用參數

{
    "type": "object",
    "properties": {
        "updateTime": {
            "description": "資料更新時間，格式：yyyyMMddhhmmss，Ex:20190101210900",
            "type": "string"
        },
        "wealthProductList": {
            "description": "投資理財之金融商品的名稱",
            "type": "object",
            "additionalProperties": {
                "type": "string"
            }
        }
    }
}

正確查詢基金投資商品資訊回應的資料模型

{
    "type": "object",
    "properties": {
        "appRepBody": {
            "$ref": "#\/definitions\/fundRef"
        },
        "appRepExtension": {
            "description": "擴充欄位，可以任意key value pair",
            "type": "object",
            "additionalProperties": {
                "type": "string"
            }
        }
    }
}

基金投資商品相關資訊

{
    "type": "object",
    "properties": {
        "fundProduct": {
            "description": "基金投資商品",
            "type": "array",
            "items": {
                "$ref": "#\/definitions\/fundProduct"
            }
        }
    }
}

基金投資商品細項資訊

{
    "type": "object",
    "properties": {
        "updateTime": {
            "description": "資料更新時間，格式：yyyyMMddhhmmss，Ex:20190101210900",
            "type": "string"
        },
        "productCode": {
            "description": "產品代號, 國際證券辨識號碼(ISIN Code)",
            "type": "string"
        },
        "customCodeName": {
            "description": "商品代號或名稱, 各銀行彈性運用供客戶辨識的自訂名稱",
            "type": "object",
            "additionalProperties": {
                "type": "string"
            }
        },
        "riskLevel": {
            "description": "風險等級",
            "type": "string",
            "enum": [
                "RR1",
                "RR2",
                "RR3",
                "RR4",
                "RR5"
            ]
        },
        "detailInfo": {
            "description": "基金投資商品說明資訊",
            "type": "object",
            "additionalProperties": {
                "type": "array",
                "items": {
                    "$ref": "#\/definitions\/fundDetail"
                }
            }
        },
        "fee": {
            "description": "基金手續費說明資訊",
            "type": "object",
            "additionalProperties": {
                "type": "array",
                "items": {
                    "$ref": "#\/definitions\/fundFeeDetail"
                }
            }
        },
        "other": {
            "description": "額外說明資訊",
            "type": "object",
            "additionalProperties": {
                "type": "string"
            }
        }
    }
}

基金細項

{
    "type": "object",
    "properties": {
        "detailName": {
            "description": "細項名稱",
            "type": "string"
        },
        "detailText": {
            "description": "細項說明",
            "type": "string"
        },
        "other": {
            "description": "對細項其它補充",
            "type": "string"
        }
    }
}

基金費用細節描述

{
    "type": "object",
    "properties": {
        "name": {
            "description": "基金費用名稱",
            "type": "string"
        },
        "countMethod": {
            "description": "基金費用計算方式, 用百分比或金額或其它方式",
            "type": "string"
        },
        "other": {
            "description": "對基金費用的補充描述",
            "type": "string"
        }
    }
}