开发者中心 - 小鱼易连

一、获取文件上传地址

功能说明

获取材料文件直传凭证。注意，一个文件只能绑定一个预约会议。文件大小限制为 30M

默认接口请求频率限制：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
fileType	String	Body	是	无	文件类型： ppt,pptx,doc,docx,xls,xlsx,pdf；	公有云不存在分区云5.2-20260928

请求示例

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

响应结果示例（HTTP 200）

{
    "storageKey": "meetingdoc/demo/01"
    "uploadToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkb2NJZCI6ImI0NDMzYzVh...(完整token)",
    "exp": 1780000600,
    "vfmHostInternal": "https://qa52.xylinkedu.com:9443/api/rest/v1/vodfile/meetingdoc/upload?securityKey=",
    "vfmHostExternal": "https://qa52.xylinkedu.com:9443/api/rest/v1/vodfile/meetingdoc/upload?securityKey="
}

根据响应结果上传文档示例

  curl -X POST \
    "https://qa52.xylinkedu.com:9443/api/rest/v1/vodfile/meetingdoc/upload?securityKey=" \
    -H "X-Upload-Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkb2NJZCI6ImI0NDMzYzVh...(完整token)" \
    -F "file=@/path/to/测试文档.pdf"
   
   上传成功后返回：
   {"data":{"docId":"b4433c5a3996495abbddfc57dd2a5d90"}}。

响应参数说明

参数	参数类型	说明	初始平台
docId	String	材料文档标识；上传文件成功后单独返回。后续查询、查询，以及预约会议绑定材料时使用。	公有云不存在分区云5.2-20260928
uploadToken	String	上传凭证；直传鉴权	公有云不存在分区云5.2-20260928
exp	Long	Unix 毫秒；凭证过期时间	公有云不存在分区云5.2-20260928
vfmHostInternal	String	URL；内网上传地址	公有云不存在分区云5.2-20260928
vfmHostExternal	String	URL；外网上传地址	公有云不存在分区云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,
        "internalDownloadUrl": "/api/rest/v1/vodfile/meetingdoc/content?storageKey=%2Fvod%2Fvodfiles%2Fmeetingdocs%2F406154b9-e4ed-4602-818a-45c
  504c38f6e%2F038dce8265ab4d56a0e85e588b7ff1a8.pdf&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9....&fileName=agenda.pdf&securityKey=",
        "externalDownloadUrl": "/api/rest/v1/vodfile/meetingdoc/content?storageKey=%2Fvod%2Fvodfiles%2Fmeetingdocs%2F406154b9-e4ed-4602-818a-45c
  504c38f6e%2F038dce8265ab4d56a0e85e588b7ff1a8.pdf&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9....&fileName=agenda.pdf&securityKey=",
        "uploadTime": 1780000000000,
        "expireTime": 1782592000000,
        "expired": false
    }
]

根据响应结果下载文档示例

  curl -k -o agenda.pdf
  "https://qa52.xylinkedu.com:9443/api/rest/v1/vodfile/meetingdoc/content?storageKey=%2Fvod%2Fvodfiles%2Fmeetingdocs%2F406154b9-e4ed-4602-818a-45c
  504c38f6e%2F038dce8265ab4d56a0e85e588b7ff1a8.pdf&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9....&fileName=agenda.pdf&securityKey="

响应参数说明

参数	参数类型	说明	初始平台
docId	String	材料文档标识	公有云不存在分区云5.2-20260928
fileName	String	文件名；	公有云不存在分区云5.2-20260928
fileType	String	文件类型	公有云不存在分区云5.2-20260928
fileSize	Long	字节数	公有云不存在分区云5.2-20260928
internalDownloadUrl	String	内网下载接口	公有云不存在分区云5.2-20260928
externalDownloadUrl	String	外网下载接口	公有云不存在分区云5.2-20260928
uploadTime	Long	Unix 毫秒，上传时间	公有云不存在分区云5.2-20260928
expireTime	Long	Unix 毫秒，到期时间	公有云不存在分区云5.2-20260928
expired	Boolean	true/false，是否到期	公有云不存在分区云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-09-02 11:58:24

导出PDF文档