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