开始前必看:招行APP userAgent说明

1.描述

客户端主要是通过UserAgent向服务器传递APP的基础环境信息,客户端在发起http请求和其webview组件启动时都会设置UserAgent,所有服务器(含手机银行服务器、第三方服务器等)在收到客户端网络请求时候都可以用过UserAgent获取当前的客户端基础环境信息。

2.字段定义

UserAgent关键字段如下所示:

字段
含义
MPBank当前APP版本号
Android/iPhone当前的设备版本,Android或者iPhone,后面附带操作系统版本号
AIDAPPID映射值,不卸载APP不会发生变化
SIDAPP启动之后的SessionID,APP不退出不变化,APP重启后发生改变
APPTag
APPTag用于特定业务标识

例如,以如下UserAgent报文为例:
MPBank/6.1.0Android/7.0AID/3Cjzry0cxDdUGE5C5D2YjawFFcM=SID/5u9IBC0FmjV1yn8L9HAdae+/EoA=APPTag/1.0(N;1234)

其中:

MPBank/6.1.0:表示当前APP版本号为6.1.0

Android/7.0:表示是Android版,7.0代表操作系统版本号;如果是iPhone版,则类似为“iPhone/11.2.1”

AID/3Cjzry0cxDdUGE5C5D2YjawFFcM=: 表示APPID的映射值,只要不卸载APP该值不会发生变化

SID/5u9IBC0FmjV1yn8L9HAdae+/EoA=: 表示APP每次启动后的SessionID,APP进程不退出不会再变化,重新启动后该值发生变化

APPTag/1.0(N;1234): APPTag用于特定业务标识,1.0表示该字段的版本号,一般不变化;N表示当前APP风格为通用版,Y表示为尊享版,具体页面都根据这个N或者Y切换为相应风格;1234目前无意义


3.调用示例

APP的UserAgent范例如下:

"UserAgent": "Mozilla/5.0 (Linux; Android 7.0; HUAWEI NXT-AL10 Build/HUAWEINXT-AL10; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/64.0.3282.137 Mobile Safari/537.36 MPBank/6.1.1 Android/7.0 AID/DtGBER+8hpLnX4sBfLJ+lPd1sMM= SID/Jqk3usiscuLpacJq3XpDjhO2hps= APPTag/1.0(N;1234)",