用于全量替换指定数据源下的对象绑定信息。
接口说明
请求说明
该 API 用于全量替换特定数据源的对象绑定(先删除现有绑定,再插入新的绑定)。如果传入空列表,则表示清空所有绑定。
安全约束:
tenant_id和user_id必须来自鉴权身份。错误处理:若指定的数据源不存在,将抛出
ERR.Robject.InvalidParameter错误,并由全局中间件转换为 POP 错误码。同步通知:替换成功后会尽力同步通知 DocumentAgent 更新
semantics.object_bindings,但失败仅记录日志,不会阻断主流程。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
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"
}
]
}