跳至主内容

获取推荐配置

调用此方法可获取特定推荐所适用的行为配置信息。

参数

名称

描述

请求包含项

类型

取值

公司ID

目标推荐所属公司的ID。

可选

备注

当目标推荐来自其他公司时为必填项。

字符串

必须为具有管理权限的有效公司ID。

默认值:请求所用API密钥关联的公司ID。

objectId

需要获取行为画像的推荐ID。

必填

字符串

必须为有效推荐ID。

这些是公共API方法通用的参数。

参数

描述

包含于请求中

类型

取值

id

该参数为请求添加标识符,用于关联对应响应。

目标方在响应中返回相同值,便于调用追踪。

必填

字符串

无额外要求

method

请求所使用的API方法名称。

必填

字符串

必须是有效的方法名称。

jsonrpc

请求和响应所使用的JSON-RPC版本。

必填

整数

可选值:

  • 2.0

params

包含请求配置的对象。

必填

对象

无额外要求。

params 对象下

page

结果页码。

可选

整数

默认值: 1

perPage

每页显示的搜索结果数量。

可选

整数

每页上限为100条。

默认值: 30

返回值

属性

类型

描述

条目

对象数组

每个对象包含行为画像的相关信息。

对象

条目

属性

类型

描述

recommendationId

字符串

适用于此行为画像的推荐ID。

behavioralProfileResource

字符串

属于该行为画像的资源ID。

behavioralProfileResourceName

字符串

属于该行为画像的资源名称。

behavioralProfileIdentity

字符串

属于该行为画像的身份ID。

行为特征身份名称

字符串

属于行为特征的身份名称。

示例

请求 :

{
  "params": {
    "page": 1,
    "perPage": 20,
    "objectId": "123abc123abc123abc123abc",
    "companyId": "456def456def456def456def",
    "search": "字体驱动主机"
  },
  "jsonrpc": "2.0",
  "method": "getRecommendationProfiles",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

响应 :

{
  "total": 9,
  "page": 1,
  "perPage": 20,
  "pagesCount": 1,
  "items": [
    {
      "recommendationId": "123abc123abc123abc123abc",
      "behavioralProfileResource": "00000000-0000-0000-0000-100000000001",
      "behavioralProfileResourceName": "WIN10-TEMPL",
      "behavioralProfileIdentity": "Local_S-1-5-96-0-0_683ebe0d21ee239251adc088",
      "behavioralProfileIdentityName": "字体驱动主机\\UMFD-0"
    },
    {
      "recommendationId": "123abc123abc123abc123abc",
      "behavioralProfileResource": "00000000-0000-0000-0000-100000000001",
      "behavioralProfileResourceName": "WIN10-TEMPL",
      "behavioralProfileIdentity": "Local_S-1-5-96-0-1_683ebe0d21ee239251adc088",
      "behavioralProfileIdentityName": "字体驱动主机\\UMFD-1"
    },
    {
      "recommendationId": "123abc123abc123abc123abc",
      "behavioralProfileResource": "00000000-0000-0000-0000-100000000001",
      "behavioralProfileResourceName": "WIN10-TEMPL",
      "behavioralProfileIdentity": "Local_S-1-5-96-0-2_683ebe0d21ee239251adc088",
      "behavioralProfileIdentityName": "字体驱动主机\\UMFD-2"
    }
  ]
}