一、匯率接口全景匯率查詢 API 通常提供四個子接口覆蓋從幣種枚舉到銀行牌價的完整場景接口路徑功能所有貨幣種類列表/list獲取系統(tǒng)支持的所有幣種代碼和名稱實時匯率查詢換算/index指定兩種貨幣和金額實時換算單個貨幣匯率列表/single一次請求獲取某幣種對所有其他貨幣的匯率銀行匯率實時查詢/bank獲取指定銀行的實時外匯牌價這四個接口組合起來可以滿足絕大多數(shù)匯率相關的業(yè)務需求。二、子接口詳解2.1 貨幣種類列表/list獲取系統(tǒng)支持的所有貨幣代碼。適合在系統(tǒng)初始化時調(diào)用一次緩存到 Redis前端下拉框的幣種選項直接從緩存讀取。import urllib3 import json host https://market.aliyun.com/detail/cmapi00065831#地址 path /list appcode 你的AppCode http urllib3.PoolManager() headers { Authorization: APPCODE appcode } response http.request(GET, host path, headersheaders) content json.loads(response.data.decode(utf-8)) if content.get(code) 1: for item in content[data][list]: print(f{item[currency]} - {item[name]})返回的data.list是一個數(shù)組每個元素包含currency貨幣代碼和name中文名稱。目前支持的幣種通常有一百多種。2.2 實時匯率查詢換算/index最常用的接口。傳入源幣種、目標幣種和金額直接返回換算結果。querys fromCNYtoUSDmoney100 url host /index ? querys response http.request(GET, url, headersheaders) data json.loads(response.data.decode(utf-8))[data] print(f匯率: 1 {data[from]} {data[exchange]} {data[to]}) print(f換算結果: {data[money]} {data[to]}) print(f更新時間: {data[updatetime]})參數(shù)說明參數(shù)必填說明from是源貨幣代碼如 CNYto是目標貨幣代碼如 USDmoney否要換算的金額默認 12.3 單個貨幣匯率列表/single一次請求可以拿到某個幣種對所有其他貨幣的匯率。適合做人民幣對全球主要貨幣匯率一覽的頁面避免前端循環(huán)請求多個幣種對。querys fromCNY url host /single ? querys response http.request(GET, url, headersheaders) data json.loads(response.data.decode(utf-8))[data] print(f基準貨幣: {data[currency]} {data[name]}) for code, info in data[list].items(): print(f {code} ({info[name]}): {info[rate]})2.4 銀行匯率實時查詢/bank查詢銀行的實時外匯牌價包含匯買、匯賣、鈔買、鈔賣四個價格。querys bank_codeICBC # 工商銀行 url host /bank ? querys response http.request(GET, url, headersheaders) data json.loads(response.data.decode(utf-8))[data] print(f銀行: {data[name]}) print(f發(fā)布時間: {data[time]}) for item in data[code_list]: print(f {item[code]} {item[name]}) print(f 匯買: {item[hui_in]} | 匯賣: {item[hui_out]}) print(f 鈔買: {item[chao_in]} | 鈔賣: {item[chao_out]})銀行簡碼ICBC工商銀行、BOC中國銀行、CCB建設銀行等。字段說明hui_in匯買價——銀行買入外匯的價格hui_out匯賣價——銀行賣出外匯的價格chao_in現(xiàn)鈔買入價chao_out現(xiàn)鈔賣出價跨境結算時實際換匯成本用的是 hui_out。三、組合使用場景場景用到的接口海淘商品定價/index 做美元→人民幣換算匯率看板/single 批量展示主要貨幣匯率換匯決策參考/bank 對比不同銀行的牌價差價多幣種結算/list 獲取幣種列表 /index 逐對換算四、總結匯率數(shù)據(jù)在跨境業(yè)務里是一個平時感覺不到出問題時很痛的隱性依賴。接入前做好選型評估接入后做好限流、精度和緩存處理日常使用基本不會有太大問題。