文件管理

查询文件详情

查询指定文件的详细信息，包括大小、解析状态、标签等

POST

/api/v1/connector/dash/describeFile

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/connector/dash/describeFile" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "file_abc123"
  }'

{
  "code": "Success",
  "message": "",
  "messageUnmodified": false,
  "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "data": {
    "fileId": "file_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxx",
    "status": "PARSE_SUCCESS",
    "fileName": "a.md",
    "fileType": "md",
    "parser": "DOCMIND_DIGITAL",
    "sizeBytes": 21,
    "uploadTime": "2026-04-01 16:03:45",
    "category": "cate_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxx"
  },
  "status": 200
}

文件状态

status	说明
`INIT`	初始化
`PARSING`	解析中
`PARSE_SUCCESS`	解析成功
`FAIL`	解析失败

若状态为 FAIL，可结合查询文件列表返回的 parseErrorMessage 排查原因，修复后通过申请上传租约重新上传。

Authorizations

string

header

required

DashScope API Key，在控制台 API Key 页面（https://bailian.console.aliyun.com/settings/apikey）获取。

Body

application/json

string

required

文件 ID，通过 listFile 获取。

Response

200-application/json

string

响应码，成功时为 Success。

integer

HTTP 状态码。

string

请求唯一标识，排查问题时请提供此 ID。

object

Show child attributes

string

文件 ID。

string

文件名。

string

文件类型，如 pdf、md、docx。

string

所属类目 ID。

enum<string>

文件状态。

Available options:INIT,PARSING,PARSE_SUCCESS,FAIL

integer

文件大小（字节）。

Required range:x >= 1

string

解析方式，如 DASHSCOPE_DOCMIND。

string

上传时间。

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/connector/dash/describeFile" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "file_abc123"
  }'

{
  "code": "Success",
  "message": "",
  "messageUnmodified": false,
  "requestId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "data": {
    "fileId": "file_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxx",
    "status": "PARSE_SUCCESS",
    "fileName": "a.md",
    "fileType": "md",
    "parser": "DOCMIND_DIGITAL",
    "sizeBytes": 21,
    "uploadTime": "2026-04-01 16:03:45",
    "category": "cate_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxx"
  },
  "status": 200
}

​文件状态

Authorizations

Body

Response

文件状态