Skip to main content
POST
上传知识文件

授权

app_key
string
query
必填

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

请求体

application/json

要创建或覆盖的文件。文件体通过 content_b64 以 Base64 文本上传,不是 multipart 上传。

rel_path
string
必填

相对于知识根目录的目标路径;已存在的文件会被覆盖。

pack_id
string

知识 ID;默认为调用者的账户范围知识。

content_b64
string

Base64 编码的文件内容;解码后必须是合法的 UTF-8 文本(拒绝二进制)。单文件上限 1 MiB。

content_type
string

MIME 类型;留空时按扩展名推断。

响应

成功

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

request_id
string
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
object

写入的文件及非阻塞提示。