ReplaceObjectBindings - 全量替换指定数据源下的对象绑定信息

更新时间:
复制 MD 格式

用于全量替换指定数据源下的对象绑定信息。

接口说明

请求说明

该 API 用于全量替换特定数据源的对象绑定(先删除现有绑定,再插入新的绑定)。如果传入空列表,则表示清空所有绑定。

  • 安全约束:tenant_id 和 user_id 必须来自鉴权身份。

  • 错误处理:若指定的数据源不存在,将抛出 ERR.Robject.InvalidParameter 错误,并由全局中间件转换为 POP 错误码。

  • 同步通知:替换成功后会尽力同步通知 DocumentAgent 更新 semantics.object_bindings,但失败仅记录日志,不会阻断主流程。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /openapi/replaceObjectBindings HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

tenantId

string

否

租户 ID,公共参数;winnexo-cli 通过 --tenant-id 显式传入。

10000

sourceId

string

是

待替换的个人 FILE 数据源 ID(租户内唯一)。

exampleSourceId

objectBindings

array<object>

是

新的对象绑定列表(全量替换;传空列表表示清空所有绑定)。

object

否

对象绑定

objectType

string

否

绑定对象类型(如 customer / project)。

string_value

objectId

string

否

绑定对象 ID。

exampleObjectId

graphName

string

否

绑定对象归属的语义图谱名(object_id 在该 graph 下唯一,必填)。

string_value

返回参数

名称

类型

描述

示例值

object

返回结果。

code

string

状态码。

200

message

string

状态码描述。

successful

requestId

string

请求 ID。

019FF406-1B10-0065-A97D-2D1920C2A03D

sourceId

string

待替换的个人 FILE 数据源 ID(租户内唯一)。

exampleSourceId

objectBindings

array<object>

对象绑定

object

对象绑定

objectType

string

绑定对象类型(如 customer / project)

string_value

objectId

string

绑定对象 ID

exampleObjectId

graphName

string

绑定对象归属的语义图谱名(object_id 在该 graph 下唯一,必填)

string_value

示例

正常返回示例

JSON格式

{
  "code": "200",
  "message": "successful",
  "requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
  "sourceId": "exampleSourceId",
  "objectBindings": [
    {
      "objectType": "string_value",
      "objectId": "exampleObjectId",
      "graphName": "string_value"
    }
  ]
}

错误码

访问错误中心错误中心查看更多错误码。

变更历史

更多信息,参考变更详情变更详情。