开发者中心 - 小鱼易连

一、获取文件上传地址

功能说明

获取材料文件直传凭证。

默认接口请求频率限制：20次/秒。

实现方法

REST URL

POST https://sdk.xylink.com/api/rest/external/{version}/ai/material/upload/url?enterpriseId=XXX&signature=XXX

请求参数说明

参数	参数类型	参数位置	是否必须	默认值	说明	初始平台
enterpriseId	String	Query	是	无	外部企业标识；应用级鉴权上下文	公有云不存在分区云5.2-20260928
signature	String	Query	是	无	现有签名规则；请求签名	公有云不存在分区云5.2-20260928
fileName	String	Body	是	无	非空，长度不超过 200；最后扩展名须与 fileType 一致；文件名	公有云不存在分区云5.2-20260928
fileSize	Long	Body	是	无	最大20971520 字节，即20 MiB	公有云不存在分区云5.2-20260928
fileType	String	Body	是	无	文件类型： ppt,pptx,doc,docx,xls,xlsx,pdf；	公有云不存在分区云5.2-20260928

请求示例

{
    "fileName": "agenda.pdf",
    "fileSize": 1048576,
    "fileType": "pdf"
}

响应结果示例（HTTP 200）

{
    "docId": "doc-demo-01",
    "storageKey": "meetingdoc/demo/01",
    "uploadToken": "",
    "exp": 1780000600,
    "vfmHostInternal": "https://vfm.internal.invalid",
    "vfmHostExternal": "https://vfm.external.invalid"
}

响应参数说明

参数	参数类型	说明	初始平台
docId	String	材料文档标识；后续查询和删除使用	公有云不存在分区云5.2-20260928
storageKey	String	VFM 对象 key；直传对象键	公有云不存在分区云5.2-20260928
uploadToken	String	VFM 上传凭证；直传鉴权	公有云不存在分区云5.2-20260928
exp	Long	Unix 秒；凭证过期时间	公有云不存在分区云5.2-20260928
vfmHostInternal	String	URL；VFM 内网地址	公有云不存在分区云5.2-20260928
vfmHostExternal	String	URL；VFM 外网地址	公有云不存在分区云5.2-20260928

二、查询当前企业材料列表

功能说明

按会议或预约上下文查询当前企业材料列表。

默认接口请求频率限制：20次/秒。

实现方法

REST URL

GET https://sdk.xylink.com/api/rest/external/{version}/ai/material/query?enterpriseId=XXX&signature=XXX

请求参数说明

参数	参数类型	参数位置	是否必须	默认值	说明	初始平台
enterpriseId	String	Query	是	无	外部企业标识；转换为 CSS 内部企业 ID	公有云不存在分区云5.2-20260928
signature	String	Query	是	无	现有签名规则；请求签名	公有云不存在分区云5.2-20260928
meetingId	String	Query	条件必填	无	与 reminderId 严格二选一；非空；直接映射 CSS meetingId	公有云不存在分区云5.2-20260928
reminderId	String	Query	条件必填	无	与 meetingId 严格二选一；非空；直接映射 CSS scheduleId	公有云不存在分区云5.2-20260928

响应结果示例（HTTP 200）

[
    {
        "docId": "doc-demo-01",
        "fileName": "agenda.pdf",
        "fileType": "pdf",
        "fileSize": 1048576,
        "parseStatus": "UNPARSED",
        "downloadUrl": "/v1/files/temp/doc-demo-01",
        "uploadTime": 1780000000000,
        "expireTime": 1782592000000,
        "expired": false,
        "vfmHostInternal": "https://vfm-internal.invalid",
        "vfmHostExternal": "https://vfm-external.invalid"
    }
]

响应参数说明

参数	参数类型	说明	初始平台
docId	String	材料文档标识	公有云不存在分区云5.2-20260928
fileName	String	文件名；外部统一字段	公有云不存在分区云5.2-20260928
fileType	String	文件类型	公有云不存在分区云5.2-20260928
fileSize	Long	字节数	公有云不存在分区云5.2-20260928
parseStatus	String	面向调用方的解析状态；由内部状态转换	公有云不存在分区云5.2-20260928
downloadUrl	String	临时下载路径；本期不新增独立下载接口	公有云不存在分区云5.2-20260928
uploadTime	Long	Unix 毫秒	公有云不存在分区云5.2-20260928
expireTime	Long	Unix 毫秒	公有云不存在分区云5.2-20260928
expired	Boolean	true/false	公有云不存在分区云5.2-20260928
vfmHostInternal	String	URL	公有云不存在分区云5.2-20260928
vfmHostExternal	String	URL	公有云不存在分区云5.2-20260928

三、删除材料

功能说明

删除当前鉴权企业上下文中的单个材料。

默认接口请求频率限制：20次/秒。

实现方法

REST URL

POST https://sdk.xylink.com/api/rest/external/{version}/ai/material/delete?enterpriseId=XXX&signature=XXX

请求参数说明

参数	参数类型	参数位置	是否必须	默认值	说明	初始平台
enterpriseId	String	Query	是	无	外部企业标识；鉴权和企业上下文	公有云不存在分区云5.2-20260928
signature	String	Query	是	无	现有签名规则；请求签名	公有云不存在分区云5.2-20260928
docId	String	Body	是	无	非空；空字符串和纯空白非法；待删除材料标识	公有云不存在分区云5.2-20260928

请求示例

{
    "docId": "doc-demo-01"
}

响应结果示例（HTTP 200，空响应体）

2026-08-13 14:39:24

导出PDF文档