文档首页/ 云空间服务 KooDrive/ API参考/ API/ AI云服务相关/ 添加AI文件通知 - AiFileResourceNotice
更新时间:2025-10-22 GMT+08:00
分享

添加AI文件通知 - AiFileResourceNotice

功能介绍

添加AI文件通知

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/fileresource/ai/notice

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token}

X-User-Id

String

用户id,用于app鉴权

X-Date

String

日期,用于app鉴权

Host

String

地址,用于app鉴权

X-Traceid

String

消息日志跟踪标识(必须58位)

language

String

国际化语言标识,符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语,不传默认美式英语

X-AIUser-Id

String

用户id,用于appId鉴权,与X-User-Id必选其一,都存在时以X-AIUser-Id的值为准

表2 请求Body参数

参数

是否必选

参数类型

描述

changedFileInfoList

Array of ChangedFileInfo objects

要触发ai整理通知的文件id列表

表3 ChangedFileInfo

参数

是否必选

参数类型

描述

fileId

String

文件ID

resourceId

String

资源ID

resourceState

String

资源类型

contextInfo

contextInfo object

上下文通知

表4 contextInfo

参数

是否必选

参数类型

描述

fullProcessFlag

String

全流程处理标记

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

状态码:401

表6 响应Body参数

参数

参数类型

描述

code

Integer

响应码

msg

String

响应信息

请求示例

添加AI文件通知请求体

/koodrive/ose/v1/fileresource/ai/notice

{
  "changedFileInfoList" : [ {
    "fileId" : "fengTest",
    "resourceId" : "fengTest",
    "resourceState" : "aifunc",
    "contextInfo" : {
      "fullProcessFlag" : "voice"
    }
  } ]
}

响应示例

状态码:200

添加AI文件通知响应成功

{
  "code" : 0,
  "msg" : "success"
}

状态码

状态码

描述

200

添加AI文件通知响应成功

401

鉴权失效

相关文档