REST 分流接口

对于 服务端 类型实验室，AB 测试提供了 REST 接口的方式，提供 AB 测试的分流能力，同时 AB 测试组件会记录分流日志，做后续指标计算的数据基础。

请求

• 接口地址：/rest/abtest

• Method：GET

• 参数：

  参数名	是否必填	备注	示例
  appId	是	mPaaS 的应用 ID	-
  workspaceId	是	mPaaS 的工作空间 ID	-
  entranceKey	是	新建服务端实验时填写的实验室 ID	-
  divertValue	是	用户 ID 或者设备 ID	-
  appVersion	否	客户端版本号	1.0.9.12
  osType	否	操作系统类型（平台类型），枚举值包括 android、ios、all。	-
  osVersion	否	客户端操作系统版本号	6.1.4
  devType	否	客户端设备的机型	-

响应

Header

Content-Type →application/json;charset=UTF-8

Body

Body 格式如下：

{
    "errCode": "",
    "errMsg": "",
    "result": {
        "expVersionId": "3",
        "labId": "2",
        "resType": "DO_GREY_AB",
        "variableInfoMap": {
            "var1": {
                "description": "var1",
                "key": "var1",
                "mdsId": "",
                "name": "var1",
                "value": "old",
                "variableType": 2
            }
        }
    },
    "success": true
}

Body 字段说明：

• errMsg：当 success 值为 false 时，显示错误原因。

• result：显示实际的分流结果。

  • expVersionId: 命中实验之后分流到的实验版本 ID，业务系统可以记录此 ID，在记录转化行为发生时记录上 divertValue （用户 ID 或设备 ID）和 expVersionId 的关系。此日志和分流日志合并后可以做自定义的指标分析。

  • labId：实验室的自增 ID，不常用。

  • resType：实验分流类型，有以下三类。

    • DO_NOTHING：未命中灰度、未命中实验、即未分流。

    • DO_GREY：命中灰度。

    • DO_GREY_AB：命中实验。

  • variableInfoMap：实验绑定的变量，是一个 Map 结构。其中 key 是实验绑定的变量名，等同于 value 里的 key 字段；value 里的 value 字段是对此变量实际的分流结果。

• success：显示分流请求是否成功，true 为成功，false 为不成功。