登记已上传的文件 - EMOO开放平台

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

or

Header 参数

Body 参数application/json必填

示例

{
    "file_key": "fk_xxx1",
    "file_name": "report.pdf",
    "file_size": 102400,
    "mime_type": "application/pdf",
    "folder_id": 5
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location 'https://app.emooai.com/open-api/v1/data/kb-file' \
--header 'Emoo-User-Id: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "file_key": "fk_xxx1",
    "file_name": "report.pdf",
    "file_size": 102400,
    "mime_type": "application/pdf",
    "folder_id": 5
}'

返回响应

🟢200

application/json

成功（code=200）或业务错误。可能错误码：

4012 data_not_found（folder_id 不属于当前应用）

4015 invalid_params（扩展名不在白名单 / 参数缺失或格式不合法）

4035 file_too_large（图片单文件超过 20MB）

4041 file_not_found（file_key 未确认上传 / 文件不存在）

4084 invalid_open_api_user_id

Bodyapplication/json

示例

successbad_extensionfile_not_found

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 101,
        "doc_key": "dk_xxx",
        "ws_app_id": 7,
        "title": "report.pdf",
        "summary": null,
        "file_key": "fk_xxx1",
        "extra": {
            "file_name": "report.pdf",
            "file_size": 102400,
            "mime_type": "application/pdf"
        },
        "scope": "enterprise",
        "folder_id": 5,
        "folder_order": 1,
        "created_at": "2026-08-11T10:00:00Z",
        "updated_at": "2026-08-11T10:00:00Z",
        "deleted_at": null
    }
}

🟠400

🟠401