a13nDocs
API 参考资源包

创建上传

相同 `Idempotency-Key` 和字节内容重复请求,返回同一上传。

POST/api/v1/uploads

相同 Idempotency-Key 和字节内容重复请求,返回同一上传。

认证与授权

认证与授权Bearer <token>

工作空间 API 密钥(a13n_...)

传递位置: header

请求头参数

Idempotency-Key*Idempotency-Key
匹配规则^[!-~]+$
长度1 <= length <= 512
X-Workspace-ID?|

登录会话作用的工作空间 ID,登录会话必须提供。API 密钥作用于自身工作空间,无需提供;禁止指定其他工作空间。

请求体

multipart/form-data

TypeScript 类型定义

在 TypeScript 中使用 request body 类型。

Multipart 表单:一个名为 file 的文件部分。

响应体

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/uploads" \  -H "Idempotency-Key: string" \  -F file="string"
{  "content_type": "string",  "digest": "string",  "filename": "string",  "size": 0,  "upload_id": "string"}