应用推荐
该方法通过ID应用推荐项，并返回每个请求项的成功与失败详情。
注意
请勿将此API路由用于允许访问请求类型的推荐项。该功能将在后续版本中支持。
参数
|
名称 |
描述 |
包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
需要应用的建议ID列表 |
必填 |
字符串数组 |
必须是有效的建议ID且属于同一公司 |
这些是公共API方法通用的参数
|
参数 |
描述 |
包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
该参数为请求添加标识符，用于关联对应响应 目标响应将返回相同值，便于调用追踪 |
必填 |
字符串 |
无额外要求 |
|
|
请求调用的方法名称 |
必填 |
字符串 |
必须是有效的方法名称 |
|
|
请求与响应所使用的JSON-RPC协议版本。 |
必填 |
整数 |
可选值：
|
|
|
包含请求配置参数的对象。 |
必填 |
对象 |
无额外要求。 |
|
在
|
||||
|
|
结果页码。 |
可选 |
整数 |
默认值：
|
|
|
每页显示的结果数量。 |
可选 |
整数 |
每页显示结果的上限为100条。
默认值：
|
返回值
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串数组 |
成功应用的建议ID列表。 |
|
|
对象数组 |
每个对象包含未能成功应用的建议信息。 |
对象
failedRecommendations
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串 |
建议的唯一标识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
}
]
}
}