民生科技小程序

小程序網絡請求轉發服務

該接口用于小程序中進行業務數據前后端交互。

由于小程序是在宿主App中的一個模塊，小程序中網絡請求需要經過宿主App和宿主App后端服務進行請求轉發，以實現App對小程序管控能力。使用該接口的必須要先在小程序管理平臺配置可訪問的接口或者域名，配置后才可訪問成功，不在白名單中的域名或者api是無法通過小程序進行業務數據請求。

接口說明

接口名稱：httpProxy

Dubbo調用：msHttpProxyService

接口描述：小程序網絡請求轉發服務。

入參

參考header通用參數

業務參數

字段名稱	字段類型	字段描述	是否必須
api	String	轉發請求api, 該api必須通過進行轉發請求白名單配置	是
data	Object	請求參數	否
method	String	請求轉發方式，POST, GET	是
dataType	String	text，只支持text方式	否
encrypted	String	加密方式，暫無業務需要	否
responseType	String	返回格式， json/text, 根據請求網站返回數據，請求網站header中Content-Type如果是application/json, 返回數據是json，其他都是string	否
miniAppCode	String	小程序碼	是

出參

字段名稱	字段類型	字段描述	是否必須
response	Object	返回數據	是
code	String	AAAAAA, 成功，其他錯誤	是
msg	String		是

response

字段名稱	字段類型	字段描述	是否必須
statusCode	int	標準http狀態碼， 200請求成功	是
returnCode	Object	后臺請求狀態對象	否
data	Object	請求數據	是
header	Object	請求header	是

樣例

dubbo協議接入：

請求url

http://localhost:9102/gw/hk_e_app/msHttpProxyService.do

請求數據格式：

{
  "request":{
      "header": {
          "appId": "3",
          "appVersion": "1.0",
          "ffVersion": "4.0",
          "transId": "httpProxy",
          "appExt": "1",
          "custType": "100",
          "signedMicroFlag": "0",
          "net": {
              "ip": "127.0.0.1",
              "netType": "WIFI_oa-test",
              "isp": "中國移動",
              "ssid": "oa-test",
              "lac": "4203",
              "cid": "10732931"
          },
          "device": {
              "osType": "03",
              "osVersion": "8.0.0",
              "brand": "samsung",
              "model": "SM-G9500",
              "uuid": "2e2bc2402301ea3e1e021362dd6b7a1e",
              "imei": "357052091333047",
              "mac": "00:9D:6B:32:00:24",
              "nfc": "1",
              "isRoot": "0",
              "imsi": "8986003915187a258429"
          },
          "reqSeq": "0"
      },
      "body": {
          "api":"http://127.0.01:8080/gw/hk_e_web/ShowMainBoard.do",
          "method":"POST",
          "data":{

          },
          "header":{

          },
          "responseType":"text",
          "encrypted":"false",
          "miniAppCode": "qHwgaSkXKx6tO4jc"
      }
  }
}

http協議接入：

請求url： http://localhost:8080/ffpaas/miniapp/httpProxy.json

請求數據格式：

{
     "request":{
        "header": {
            "appId": "3",
            "appVersion": "1.0",
            "ffVersion": "4.0",
            "transId": "httpProxy",
            "appExt": "1",
            "custType": "100",
            "signedMicroFlag": "0",
            "net": {
                "ip": "127.0.0.1",
                "netType": "WIFI_oa-test",
                "isp": "中國移動",
                "ssid": "oa-test",
                "lac": "4203",
                "cid": "10732931"
            },
            "device": {
                "osType": "03",
                "osVersion": "8.0.0",
                "brand": "samsung",
                "model": "SM-G9500",
                "uuid": "2e2bc2402301ea3e1e021362dd6b7a1e",
                "imei": "357052091333047",
                "mac": "00:9D:6B:32:00:24",
                "nfc": "1",
                "isRoot": "0",
                "imsi": "8986003915187a258429"
            },
            "reqSeq": "0"
        },
        "body": {
            "api":"http://127.0.01:8080/gw/hk_e_web/ShowMainBoard.do",
            "method":"POST",
            "data":{

            },
            "header":{

            },
            "responseType":"text",
            "encrypted":"false",
            "miniAppCode": "qHwgaSkXKx6tO4jc"
        }
    }
}

dsdl配置

節點配置

msHttpProxyService$applicationName,true

說明：

applicationName修改為應用

xml參數配置

創建節點，節點名稱為interface-mapping
添加配置參數信息，如下

<?xml version="1.0" encoding="UTF-8"?>

<interface name="msHttpProxyService" description="http代理服務" auth="false">
    <configs>
        <config key="accessLog" value="false"/>
        <config key="transDataRecordMode" value="on"/>
        <config key="productId" value="ECommon"/>
    </configs>
    <input>
        <param name="api" description="請求地址" type="String" optional="false"/>
        <param name="method" description="請求方式" type="String" optional="false"/>
        <param name="data" description="數據" type="Map" optional="true"/>
        <param name="header" description="header" type="Map" optional="true"/>
        <param name="responseType" description="響應數據類型" type="String" optional="true"/>
        <param name="encrypted" description="是否加密" type="String" optional="true"/>
        <param name="miniAppCode" description="miniAppCode" type="String" optional="true"/>
    </input>
    <output>
        <param name="returnCode" description="處理結果" type="Map" optional="false">
            <param name="code" description="返回碼" type="String" optional="false"/>
            <param name="message" description="返回信息" type="String"/>
            <param name="type" description="處理結果類型" type="String" optional="false"/>
        </param>
        <param name="data" type="Object"/>
        <param name="statusCode" type="int"/>
        <param name="header" type="Map"/>
    </output>
</interface>