遍历用户的特征项

  1. 请求地址:GET /users/user/{guid}/features

  2. 接口概述:

    遍历指定用户的特征项。

  3. 请求参数:

    参数名 参数类型 参数说明 必需 备注
    offset integer 响应结果起始下标 默认0
    limit integer 响应结果的数量 默认50,最大1000

    如何遍历?

    地址参数

    参数名 参数类型 参数说明 必需 备注
    guid string 用户唯一标识符
  4. 请求体:

  5. 请求示例:

    GET /bitanswer/api/users/user/{guid}/features HTTP/1.1
    Host: back-office-api.bitanswer.cn
    bitkey: ••••••
  6. 响应示例:

    {
       "status": 0,
       "data": {
           "total": 3,
           "items": [
               {
                   "name": "feature_name_1"
               },
               {
                   "name": "feature_name_2"
               },
               {
                   "name": "feature_name_3"
               }
           ]
       }
    }

    响应体说明

    只返回特征项名称,total标识角色下特征项的总数,items只返回特征项的名称,当名称重复时会进行去重。

为用户关联特征项

  1. 请求地址:POST /users/user/{guid}/features

  2. 接口概述:

    给用户关联指定产品的指定模版,并关联指定名称的特征项。已关联的不会重复关联,不属于本产品的特征项不会关联,返回用户在这个产品模版下关联的特征项名称列表。

  3. 请求参数:

    地址参数

    参数名 参数类型 参数说明 必需 备注
    guid string 用户的唯一标识符
  4. 请求体:

    参数名 参数类型 参数说明 必需 备注
    productGuid string 产品的guid
    templateName string 模版名称 当features数组是空时,用户只关联当前模版
    features array 特征项名称列表 由string类型组成的数组,当数组不是空时,在关联当前模版基础上关联这些特征项
  5. 请求示例:

    POST /bitanswer/api/users/user/{guid}/features HTTP/1.1
    Host: back-office-api.bitanswer.cn
    Content-Type: application/json
    bitkey: ••••••
    
    {
       "productGuid":"xxxxxx",
       "templateName":"template_name",
       "features":[
           "feature_name_1",
           "feature_name_2"
       ]
    }
  6. 响应示例:

    {
       "status": 0,
       "data": {
           "total": 2,
           "items": [
               {
                   "name": "feature_name_1"
               },
               {
                   "name": "feature_name_2"
               },
               {
                   "name": "feature_name_3"
               },
               {
                   "name": "feature_name_4"
               }
           ]
       }
    }

    响应体说明

取消用户关联的特征项

  1. 请求地址:DELETE /users/user/{guid}/features

  2. 接口概述:

    取消用户关联的特征项。未传特征项列表:取消整个模版关联,同时取消在当前模版基础上的一切特征项的勾选、取消勾选。传特征项列表:仅在当前模版基础上取消勾选这些特征项,未关联的特征项忽略。返回用户在这个产品模版下关联的特征项名称列表。

  3. 请求参数:

    地址参数

    参数名 参数类型 参数说明 必需 备注
    guid string 用户的唯一标识符
  4. 请求体:

    参数名 参数类型 参数说明 必需 备注
    productGuid string 产品的guid
    templateName string 模版名称 当features数组是空时,取消整个模版关联,同时取消在当前模版基础上的一切特征项的勾选、取消勾选。
    features array 特征项名称列表 由string类型组成的数组。当数组不是空时,仅在当前模版基础上取消勾选这些特征项,未关联的特征项忽略。
  5. 请求示例:

    DELETE /bitanswer/api/users/user/{guid}/features HTTP/1.1
    Host: back-office-api.bitanswer.cn
    Content-Type: application/json
    bitkey: ••••••
    
    {
       "productGuid":"xxxxxx",
       "templateName":"template_name",
       "features":[
           "feature_name_1",
           "feature_name_2"
       ]
    }
  6. 响应示例:

    {
       "status": 0,
       "data": {
           "total": 2,
           "items": [
               {
                   "name": "feature_name_3"
               },
               {
                   "name": "feature_name_4"
               }
           ]
       }
    }

    响应体说明