获取预签名上传 URL

POST

/documents/presign

获取 OSS 预签名上传 URL，用于前端直传文件到 OSS（绕过 Vercel Functions 4.5MB 请求体限制）
之后，应该调用/documents/{document_id}/confirm这个api来确认上传，触发索引。
此接口被调用后，会在数据库里的documents表插入关于这个文档的新记录，status字段为pending

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "filename": "document.pdf",
    "file_size": 10485760,
    "content_type": "application/pdf"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/documents/presign' \
--header 'X-User-ID: {{X-User-ID}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filename": "document.pdf",
    "file_size": 10485760,
    "content_type": "application/pdf"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "document_id": 1,
    "upload_url": "https://bucket.oss-cn-xxx.aliyuncs.com/users/123/documents/1/document.pdf?OSSAccessKeyId=xxx&Expires=xxx&Signature=xxx",
    "oss_path": "users/123/documents/1/document.pdf",
    "expires_in": 600
}

🟠400文件类型错误

🟠400文件过大

🟠422422 参数错误

修改于 2025-12-04 05:17:20

[说明] 文件上传指南

确认文件上传