# Cloud Storage Open API

Quản lý tệp, lượt tải lên, lượt xóa và nhãn tệp của cloud storage MoreLogin thông qua MoreLogin Open API.

**URL cơ sở**: `https://api.morelogin.com`

Xác thực được thực hiện bằng token Bearer OAuth2. Xem [Xác thực](../Getting%20Started/authentication.md) để biết chi tiết.


Version: 2026-09-05

## Servers

```
https://api.morelogin.com
```

## Security

### Authorization

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

 - [Cloud Storage Open API](https://guide.morelogin.com/_bundle/@l10n/vi/API%20Reference/Cloud%20Storage/open-api.yaml)

## Cloud Storage

 - [GET /cloudstorage/info](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage/querycloudstorageinfo.md): Trả về hạn mức cloud storage của nhóm và mức sử dụng hiện tại. - **Điều kiện tiên quyết**: nhóm phải đã có bản ghi cloud storage. **Một nhóm chưa từng được cấp cloud storage sẽ nhận về lỗi, không phải
## Cloud Storage Files

 - [POST /cloudstorage/file/page](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-files/pagecloudstoragefiles.md): Liệt kê theo trang các tệp Cloud Storage. - **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn. - **Khả năng nhìn thấy**: **chỉ những tệp đã xác nhận tải lên m
 - [POST /cloudstorage/upload/init](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-files/batchrequestcloudstoragepresigneduploadurls.md): Đặt trước các bản ghi cloud storage và lấy URL tải lên đã ký trước. - **Điều kiện tiên quyết**: nhóm phải có bản ghi cloud storage và bản ghi đó không được hết hạn. Phần tên cơ sở của mỗi tệp giới hạn
 - [POST /cloudstorage/upload/complete](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-files/confirmcloudstorageuploadcomplete.md): Xác nhận một tệp cloud storage đã được tải lên. - **Điều kiện tiên quyết**: bản ghi tệp phải thuộc nhóm của bạn và đối tượng phải đã nằm trong bộ lưu trữ — dịch vụ đọc ETag và độ dài của nó để kiểm ch
 - [POST /cloudstorage/file/delete/batch](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-files/batchdeletecloudstoragefiles.md): Xóa các tệp Cloud Storage theo ID. - **Điều kiện tiên quyết**: mọi ID phải tra cứu được trong nhóm của bạn; **nếu chỉ một ID không tra cứu được thì cả lô bị từ chối và hoàn tác**, kể cả những ID đã bị
## Cloud Storage File Tags

 - [POST /cloudstorage/file/tag/set](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-file-tags/setcloudstoragefiletags.md): Thay thế toàn bộ thẻ của một tệp Cloud Storage. - **Điều kiện tiên quyết**: mỗi lần gọi một `fileId`, và `tagIds` không được rỗng và phải tham chiếu tới các thẻ Cloud Storage thuộc nhóm của bạn. Thẻ c
 - [POST /cloudstorage/file/tag/add](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-file-tags/addcloudstoragefiletags.md): Thêm thẻ cho một tệp Cloud Storage mà không bỏ các thẻ hiện có. - **Điều kiện tiên quyết**: mỗi lần gọi một `fileId`, và `tagIds` không được rỗng và phải tham chiếu tới các thẻ Cloud Storage thuộc nhó
 - [POST /cloudstorage/file/tag/query](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-file-tags/querycloudstoragefiletags.md): Trả về các thẻ đang gắn với một hoặc nhiều tệp Cloud Storage. - **Điều kiện tiên quyết**: mọi `fileId` phải tra cứu được trong nhóm của bạn; **một ID không xác định sẽ làm cả lệnh gọi thất bại** chứ k
 - [GET /cloudstorage/tag/all](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-file-tags/queryallcloudstoragefiletags.md): Trả về mọi thẻ tệp Cloud Storage trong nhóm. - **Tác động**: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn. - **Lưu ý**: endpoint không phân trang, và thẻ Cloud Storage
 - [POST /cloudstorage/tag/create](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-file-tags/createcloudstoragefiletag.md): Tạo một thẻ tệp Cloud Storage. - **Điều kiện tiên quyết**: `tagName` không được để trống. - **Tác động**: tạo thẻ với một màu chọn từ bảng màu cố định. **Tên không được kiểm tra trùng lặp và không có
 - [POST /cloudstorage/tag/edit](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-file-tags/editcloudstoragefiletag.md): Đổi tên một thẻ tệp Cloud Storage. - **Điều kiện tiên quyết**: thẻ phải tồn tại trong nhóm của bạn và phải là thẻ Cloud Storage. - **Tác động**: chỉ tên thay đổi; màu và mọi liên kết hiện có đều được
 - [POST /cloudstorage/tag/delete/batch](https://guide.morelogin.com/vi/api-reference/cloud-storage/open-api/cloud-storage-file-tags/deletecloudstoragefiletags.md): Xóa các thẻ tệp Cloud Storage. - **Điều kiện tiên quyết**: mọi ID phải là thẻ Cloud Storage trong nhóm của bạn; **một ID không hợp lệ sẽ làm cả lô thất bại**. - **Tác động**: các thẻ bị xóa nhưng **li