Files

HolaCloud Files 提供 REST API,用 bucket 保存文件。文件路径位于 /files/ 之后,列表接口使用 /list/ 之后的路径作为前缀过滤。

认证

所有 /v1 endpoint 都需要 X-Glue-Authentication header:

1X-Glue-Authentication: {"user":{"id":"user-123"}}

数据模型

Bucket 字段:id, project_id, created_timestamp, owners, name, description

File 字段:id, uuid, created_timestamp, updated_timestamp, owners, status, size, name, bucket, hash_md5, hash_sha256, mime_type

API 参考

所有 endpoint 使用 base URL https://api.hola.cloud

方法 路径 说明
GET /v1/buckets 列出认证用户的 buckets
POST /v1/buckets 创建 bucket
GET /v1/buckets/{bucket_id} 获取 bucket 详情
PATCH /v1/buckets/{bucket_id} 未实现
DELETE /v1/buckets/{bucket_id} 删除 bucket
GET /v1/buckets/{bucket_id}/list/* 列出文件,可按前缀过滤
PUT /v1/buckets/{bucket_id}/files/* 上传文件
GET /v1/buckets/{bucket_id}/files/* 下载文件,或使用 ?metadata 返回 JSON metadata
DELETE /v1/buckets/{bucket_id}/files/* 删除文件
HEAD /v1/buckets/{bucket_id}/files/* 返回文件 headers

评论

发表评论