applyRecommendations
此方法通过ID应用推荐，并返回每个请求的成功与失败详情。
注意
请勿将此API路由用于允许访问请求类型的推荐。该功能将在后续版本中提供支持。
参数
|
名称 |
描述 |
包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
需要应用的推荐ID列表。 |
必填 |
字符串数组 |
必须是有效的推荐ID且属于同一公司。 |
以下是通用参数，适用于所有公共API方法。
|
参数 |
描述 |
是否包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
该参数为请求添加标识符，用于关联对应的响应。 目标响应中会返回相同的值，便于追踪调用。 |
必填 |
字符串 |
无额外要求 |
|
|
请求所使用的方法名称。 |
必填 |
字符串 |
必须是有效的方法名。 |
|
|
请求与响应所使用的JSON-RPC版本。 |
必填 |
整数 |
可选值：
|
|
|
包含请求配置的对象。 |
必需 |
对象 |
无额外要求。 |
|
在
|
||||
|
|
结果页码。 |
可选 |
整数 |
默认值：
|
|
|
每页显示的结果数量。 |
可选 |
整数 |
每页上限为100项。
默认值：
|
返回值
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串数组 |
成功应用的建议ID。 |
|
|
对象数组 |
每个对象包含未能成功应用的建议信息。 |
对象
失败建议
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串 |
建议的唯一标识符。 |
|
|
字符串 |
尝试应用建议时发生的错误描述。 |
|
|
整数 |
错误对应的代码。 |
示例
请求 :
{
"params": {
"recommendationIds": [
"68480f4e11e8dc005bb0f9e7",
"6853e32b4783f7a2f15582c4",
"6853e32b4783f7a2f15582cf"
],
"companyId": "67fe8595d4db0d536908ec92"
},
"jsonrpc": "2.0",
"method": "applyRecommendations",
"id": "b7e2c1d4-9f8a-4c2e-8b1a-ef1234567890"
}
响应 :
{
"id": "b7e2c1d4-9f8a-4c2e-8b1a-ef1234567890",
"jsonrpc": "2.0",
"result": {
"appliedRecommendations": [],
"failedRecommendations": [
{
"recommendationId": "68480f4e11e8dc005bb0f9e7",
"error": "建议已被应用。",
"errorCode": 3432
},
{
"recommendationId": "6853e32b4783f7a2f15582c4",
"error": "建议已被应用。",
"errorCode": 3432
},
{
"recommendationId": "6853e32b4783f7a2f15582cf",
"error": "未找到建议。",
"errorCode": 3432
}
]
}
}