功能接口
APP初始化服務
接口名稱:appInit
Dubbo調用: msAppInitService
接口描述:客戶端初始化請求接口,聚合app在(zài)啓動時(shí)需要(yào / yāo)進行的(de)多次網絡請求的(de)接口, 解決多次網絡請求會導緻客戶端的(de)性能問題和(hé / huò)網絡流量增加問題。 所以(yǐ)抽象出(chū)客戶端初始化接口,把啓動時(shí)用到(dào)的(de)網絡請求聚合成爲(wéi / wèi)一(yī / yì /yí)次網絡請求, 啓動時(shí)一(yī / yì /yí)次網絡請求即可獲取多項數據, 減少網絡請求次數,從而(ér)提高app性能。 目前客戶端初始化接口返回splash和(hé / huò)版本更新兩部分業務。
動态菜單服務
接口名稱:remoteUI
Dubbo調用: msRemoteUIService
接口描述:
客戶端開發平台封裝了(le/liǎo)一(yī / yì /yí)套完整的(de)動态UI功能,使得開發人(rén)員可在(zài)服務端動态的(de)修改NativeUI,客戶端開發人(rén)員隻需在(zài)應用啓動時(shí)從服務端獲取到(dào)動态UI并在(zài)需要(yào / yāo)動态UI時(shí)初始化即可。動态UI提供了(le/liǎo)一(yī / yì /yí)套完整的(de)UI獲取及顯示功能,動态UI可以(yǐ)從服務端獲取也(yě)可以(yǐ)從本地(dì / de)獲取, 相比靜态UI更加靈活,易于(yú)維護更新,動态UI數據通過Json獲取,動态UI結構爲(wéi / wèi)樹形結構,用哈希表以(yǐ)動态UI的(de)ID爲(wéi / wèi)索引存儲和(hé / huò)讀取,速度快效率高。
NaviteUI動态菜單配置接口給客戶端提供動态菜單服務端配置信息, 通過該接口可動态獲取和(hé / huò)設置客戶端需要(yào / yāo)顯示的(de)菜單, 對運營、推廣有很大(dà)的(de)方便, 結合AI和(hé / huò)大(dà)數據,可根據每個(gè)用戶習慣提供不(bù)同的(de)UI展示内容和(hé / huò)效果,爲(wéi / wèi)用戶提供個(gè)性化的(de)App。 客戶端NativeUI動态菜單配置信息獲取接口。 使用詳情參考動态NativeUI框架
Splash服務
接口名稱:loadingInfo
Dubbo調用:msLoadingInfoService
接口描述:客戶端啓動時(shí)Splash配置信息獲取接口, 在(zài)管理後台進行Splash數據的(de)配置,如Splash图片、顯示時(shí)間、顯示時(shí)常、點擊跳轉地(dì / de)址等信息的(de)配置,客戶端即可快速集成一(yī / yì /yí)套爲(wéi / wèi)app定制化的(de)廣告、運營場景。 使用詳情參考Splash組件
版本更新服務
接口名稱:versionUpgrade
Dubbo調用:msVersionService
接口描述:客戶端版本升級接口信息獲取接口, 在(zài)後台配置每個(gè)版本使用的(de)升級方式, 是(shì)否可以(yǐ)升級,升級提示内容等信息, Android可直接下載,iOS可配置跳轉app store進行版本更新, 開發者即可快速集成版本升級功能, 從而(ér)把主要(yào / yāo)精力放在(zài)主要(yào / yāo)業務。 使用詳情參考應用更新
Web本地(dì / de)化插件服務
接口名稱:webPlugins
Dubbo調用:msGetWebPluginsService
接口描述:移動端集成了(le/liǎo)Web本地(dì / de)化實現的(de)整體技術方案, Web本地(dì / de)化插件的(de)集成,可明顯提高Web性能, 增加客戶端的(de)靈活性, 并且屏蔽平台差異。 Web本地(dì / de)化模版更新的(de)策略和(hé / huò)數據,需要(yào / yāo)通過管理後台進行配置,然後通過該接口獲取, 客戶端進行安全校驗和(hé / huò)更新。 使用詳情參考H5容器和(hé / huò)離線包-PaaS服務
Web白名單服務
接口名稱:whiteList
Dubbo調用:msWhiteListService
接口描述:移動開發平台提供了(le/liǎo)Web本地(dì / de)化的(de)整體技術解決方案和(hé / huò)銀行經驗, 在(zài)此基礎上(shàng)進行web網絡請求的(de)白名單限制, 自動實現過濾功能,避免出(chū)現涉黃、涉恐信息。 白名單功能支持開發者自定義網絡請求的(de)白名單, 更新的(de)的(de)白名單信息可通過該服務到(dào)達客戶端, 進行客戶端本地(dì / de)數據的(de)過濾。使用詳情參考H5容器和(hé / huò)離線包-PaaS服務
小程序配置信息服務
接口名稱: miniAppInfo
Dubbo調用:msQueryMiniAppInfoService
接口描述:小程序是(shì)移動開發平台提供面向未來(lái)的(de)以(yǐ)東段生态環境,小程序的(de)logo、名稱、描述、權限等信息在(zài)後台配置之(zhī)後,可以(yǐ)通過該接口拉去最新的(de)配置信息, 客戶端根據最新的(de)配置信息,進行小程序的(de)更新。 使用詳情參考小程序-後台接口
小程序請求轉發服務
接口名稱:msHttpProxyService
接口描述:小程序請求轉發接口是(shì)給小程序提供的(de)業務轉發服務接口,是(shì)小程序實現管控功能的(de)重要(yào / yāo)手段。 通過小程序管理平台進行配置的(de)api才可以(yǐ)進行請求轉發,不(bù)在(zài)白名單中的(de)域名或者api是(shì)無法通過小程序進行業務數據請求。使用詳情參考小程序-後台接口
網絡協議設計
網絡請求上(shàng)行參數分通用字段和(hé / huò)業務字段兩部分,通用字段放在(zài)header中, 業務字段放到(dào)body中。
字段名稱 | 字段類型 | 字段描述 | 是(shì)否必須 |
---|---|---|---|
header | object | 請求通用字段 | 是(shì) |
body | object | 請求業務字段 | 否 |
body見各接口業務參數
body見各接口業務參數
header通用參數
字段名稱 | 字段類型 | 字段描述 | 是(shì)否必須 |
---|---|---|---|
appId | String | 應用ID | 是(shì) |
appVersion | String | 應用版本号 | 是(shì) |
ffVersion | String | Firefly SDK版本号 | 是(shì) |
transId | String | 請求function名稱 | 是(shì) |
appExt | String | 否 | |
custType | String | 否 | |
signedMicroFlag | String | 否 | |
reqSeq | String | 0 | 否 |
net | Object | 網絡信息,參考net 網絡信息 | 是(shì) |
device | Object | 設備信息,參考device 設備信息 | 是(shì) |
net網絡信息
字段名稱 | 字段類型 | 字段描述 | 是(shì)否必須 |
---|---|---|---|
ip | String | IP地(dì / de)址 | 是(shì) |
netType | String | 網絡類型 | 否 |
isp | String | 運營商,如中国移動 | 否 |
ssid | String | WIFI服務标識 | 否 |
lac | String | 位置區域碼 | 否 |
cid | String | 基站編号 | 否 |
device設備信息
字段名稱 | 字段類型 | 字段描述 | 是(shì)否必須 |
---|---|---|---|
osType | String | 設備類型 01-iOS,02-Android,03-iPad,04-Windows Phone | 是(shì) |
osVersion | String | 設備版本号 | 是(shì) |
brand | String | 廠商,如xiaomi、HUAWEI | 是(shì) |
model | String | 設備型号,如samsungSM-N9005 | 是(shì) |
uuid | String | 設備唯一(yī / yì /yí)标識 | 是(shì) |
imei | String | IMEI号 | 是(shì) |
mac | String | MAC地(dì / de)址 | 是(shì) |
nfc | String | 是(shì)否支持NFC,0-不(bù)支持,1-支持 | 是(shì) |
isRoot | String | 是(shì)否ROOT提權,0-未提權,1-提權 | 是(shì) |
imsi | String | SIM卡序列号 | 否 |
錯誤碼
字段名稱 | 字段類型 | 字段描述 | 是(shì)否必須 |
---|---|---|---|
AAAAAA | String | success | 是(shì) |
other | String | failed | 是(shì) |