获取会话产物路径映射
更新时间：2026-09-11
GET
https://api.dumate.cn/api/v1/sessions/{sessionId}/artifact/path-map
本接口用于按产物路径查询会话（Session）的产物信息，并换取临时下载地址。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
sessionId
string
会话（Session）标识，由创建会话接口返回。
必选
Query 参数
path
string
要查询的产物路径。
可重复传入同名参数，以一次查询多个产物。
不传时返回会话内全部产物的路径映射。
路径中的中文和特殊字符需按 URL 编码后传入。
可选
请求结构
GET /api/v1/sessions/{sessionId}/artifact/path-map HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
请求示例
curl --get --location "https://api.dumate.cn/api/v1/sessions/ses_01ABC/artifact/path-map" \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--data-urlencode 'path=油价影响分析.md' \
--data-urlencode 'path=附件/价格走势.xlsx'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
{path}
object {15}
产物对象。
key 为查询的产物路径原值。
可选
显示子属性
隐藏子属性
artifactID
string
产物唯一标识。
可选
filename
string
文件名。
可选
relativePath
string
相对会话工作目录的路径。
可选
path
string
产物完整路径。
可选
mimeType
string
文件 MIME 类型。
可选
fileType
string
文件分类。
例如 image、video、audio、pdf、document、text、other。
可选
uploadStatus
string
上传状态。
例如 pending、uploading、ready、failed。
可选
previewStatus
string
预览文件处理状态。
可选
previewMode
string
预览方式。
例如 pdf、download、none。
可选
previewUrl
stringnull
临时预览地址。
可选
downloadUrl
stringnull
临时下载地址。uploadStatus 为 ready 时返回。
可选
pdfUrl
stringnull
PDF 版本临时地址。
可选
errorCode
stringnull
处理失败时的错误码。
可选
errorMessage
stringnull
处理失败时的错误详情。
可选
timeUpdated
integer
最后更新时间，Unix 毫秒时间戳。
可选
响应示例
{
"油价影响分析.md": {
"artifactID": "art_01hhhh",
"filename": "油价影响分析.md",
"relativePath": "油价影响分析.md",
"path": "油价影响分析.md",
"mimeType": "text/markdown",
"fileType": "text",
"uploadStatus": "ready",
"previewStatus": "none",
"previewMode": "download",
"previewUrl": "<ARTIFACT_PREVIEW_URL>",
"downloadUrl": "<ARTIFACT_DOWNLOAD_URL>",
"pdfUrl": null,
"errorCode": null,
"errorMessage": null,
"timeUpdated": 1786000019000
},
"附件/价格走势.xlsx": {
"artifactID": "art_01jjjj",
"filename": "价格走势.xlsx",
"relativePath": "附件/价格走势.xlsx",
"path": "附件/价格走势.xlsx",
"mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"fileType": "document",
"uploadStatus": "ready",
"previewStatus": "ready",
"previewMode": "pdf",
"previewUrl": "<ARTIFACT_PREVIEW_URL>",
"downloadUrl": "<ARTIFACT_DOWNLOAD_URL>",
"pdfUrl": "<ARTIFACT_PDF_URL>",
"errorCode": null,
"errorMessage": null,
"timeUpdated": 1786000021000
}
}评价此篇文章