Cloud Storage

Cloud Storage là không gian tệp ở cấp nhóm, dùng để lưu những tệp cần dùng lại trong các luồng tự động hóa của MoreLogin. Hãy tải lên một lần, sắp xếp bằng thẻ, tìm lại sau và xóa những tệp không còn cần.

Nó khác với các API truyền tệp của Cloud Phone. API tệp của Cloud Phone chuyển tệp vào hoặc ra khỏi một thiết bị cụ thể. API Cloud Storage quản lý thư viện tệp dùng chung, tức là trước khi tệp được thiết bị, lịch chạy, mẫu RPA hay logic tự động hóa khác sử dụng.

• Tải APK, tệp media, tài liệu hoặc tài nguyên kiểm thử lên một lần rồi dùng lại trong tự động hóa.
• Giữ tệp được sắp xếp theo khách hàng, chiến dịch, phiên bản ứng dụng, môi trường hoặc luồng công việc.
• Tạo bộ chọn tệp trong công cụ nội bộ của bạn bằng cách gọi API phân trang tệp kèm bộ lọc tên tệp và thẻ.
• Dọn dẹp hàng loạt các tệp đã hết hạn hoặc không dùng sau khi một luồng kết thúc.
• Đồng bộ hệ thống tài nguyên bên ngoài với MoreLogin bằng cách tạo thẻ và gắn chúng vào các tệp đã tải lên.

Chi tiết xác thực xem tại Xác thực.

Việc tải lên Cloud Storage dùng luồng URL đã ký trước. Mã của bạn không tải tệp nhị phân trực tiếp lên API MoreLogin.

1. Gọi Xin hàng loạt URL tải lên đã ký trước kèm danh sách tên tệp (có phần mở rộng).
2. Với mỗi phần tử trả về, tải tệp nhị phân lên presignedUrl bằng PUT qua HTTPS.
3. Gọi Xác nhận hoàn tất tải lên với id tệp được trả về.
4. Dùng Phân trang tệp cloud storage hoặc Truy vấn thẻ của tệp để kiểm tra và hiển thị tệp đã tải lên.

# 1. Request a presigned upload URL
curl -X POST "https://api.morelogin.com/cloudstorage/upload/init" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileNames": ["example.jpg"]
  }'

# 2. Upload file content to the returned presignedUrl
curl -X PUT "PRESIGNED_URL_FROM_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary "@example.jpg"

# 3. Confirm upload completion (id from step 1 response)
curl -X POST "https://api.morelogin.com/cloudstorage/upload/complete" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 1800000000000001
  }'

Với Local API, hãy giữ nguyên body request và thay đường dẫn thành http://127.0.0.1:40000/api/cloudstorage/....

Sau khi tệp được tải lên và xác nhận, tham số mẫu RPA của Cloud Phone có thể tham chiếu tệp đó bằng ID tệp Cloud Storage. Hãy dùng giao thức tệp đám mây của MoreLogin thay vì URL tải xuống công khai bên ngoài:

morelogin://cloudfile?ids=1,2

ids là danh sách ID tệp Cloud Storage phân tách bằng dấu phẩy. Chỉ dùng dấu phẩy tiếng Anh, không có khoảng trắng. Bạn có thể lấy ID tệp từ phản hồi hoàn tất tải lên hoặc từ Phân trang tệp cloud storage.

Một tệp:

morelogin://cloudfile?ids=1800000000001001

Nhiều tệp:

morelogin://cloudfile?ids=1800000000001001,1800000000001002

Khi tham số RPA là loại media hoặc tệp, hãy giữ metadata __Extra__ bắt buộc và đặt giá trị tham số là URI giao thức tệp đám mây:

{
  "__Extra__": {
    "videoDownloadUrl": { "name": "video.mp4", "size": 204800000 }
  },
  "videoDownloadUrl": "morelogin://cloudfile?ids=1,2"
}

Điều này hữu ích cho các tác vụ RPA Cloud Phone theo lịch, mẫu trên marketplace, mẫu cá nhân, và bất kỳ tham số node RPA nào mong đợi một tệp đã tải lên dùng lại được. Runtime RPA phân giải tệp từ Cloud Storage của MoreLogin, nên tệp không cần được công khai qua URL HTTPS.

Ví dụ này tải video.mp4 lên Cloud Storage, gắn một thẻ, rồi tạo một tác vụ RPA Cloud Phone chạy một lần dùng tệp đã tải lên trong tham số mẫu videoDownloadUrl.

Ví dụ dùng đường dẫn Local API. Với Open API, hãy giữ nguyên body request và thay:

• http://127.0.0.1:40000/api/cloudstorage/... thành https://api.morelogin.com/cloudstorage/...
• http://127.0.0.1:40000/api/cloudphone/... thành https://api.morelogin.com/cloudphone/...

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/tag/create" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tagName": "RPA Assets"
  }'

Lưu id của thẻ được trả về, ví dụ 1800000000000101.

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/upload/init" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileNames": ["video.mp4"]
  }'

Lưu id tệp được trả về và presignedUrl.

Tải nội dung tệp lên presignedUrl. Request này đi tới URL object storage được trả về ở bước trước, không đi tới API MoreLogin.

curl -X PUT "PRESIGNED_URL_FROM_RESPONSE" \
  -H "Content-Type: video/mp4" \
  --data-binary "@video.mp4"

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/upload/complete" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 1800000000000001
  }'

Lưu ID tệp Cloud Storage được trả về, ví dụ 1800000000001001.

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/file/tag/add" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": 1800000000001001,
    "tagIds": [1800000000000101]
  }'

Nếu phản hồi hoàn tất tải lên không trả về trực tiếp ID tệp, hãy truy vấn tệp theo trang:

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/file/page" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pageNo": 1,
    "pageSize": 20,
    "fileName": "video",
    "tagIds": [1800000000000101]
  }'

Dùng ID tệp Cloud Storage trong giao thức tệp đám mây của MoreLogin:

morelogin://cloudfile?ids=1800000000001001

Với tham số mẫu RPA tên videoDownloadUrl, hãy dựng đối tượng JSON như sau:

{
  "__Extra__": {
    "videoDownloadUrl": {
      "name": "video.mp4",
      "size": 204800000
    }
  },
  "videoDownloadUrl": "morelogin://cloudfile?ids=1800000000001001"
}

Sau đó escape nó thành chuỗi JSON cho templateParameter:

"{\"__Extra__\":{\"videoDownloadUrl\":{\"name\":\"video.mp4\",\"size\":204800000}},\"videoDownloadUrl\":\"morelogin://cloudfile?ids=1800000000001001\"}"

Trước khi tạo tác vụ, hãy lấy cloudPhoneId từ API danh sách Cloud Phone và templateId từ API danh sách mẫu trên marketplace hoặc mẫu cá nhân.

curl -X POST "http://127.0.0.1:40000/api/cloudphone/rpa/onceTask/save" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cloudPhoneId": 1678331966138097,
    "scheduleName": "Upload video from Cloud Storage",
    "templateId": 1678347487160256,
    "templateParameter": "{\"__Extra__\":{\"videoDownloadUrl\":{\"name\":\"video.mp4\",\"size\":204800000}},\"videoDownloadUrl\":\"morelogin://cloudfile?ids=1800000000001001\"}",
    "description": "Use a Cloud Storage video file in a one-time Cloud Phone RPA task"
  }'

Truy vấn danh sách tác vụ hoặc danh sách tác vụ con của RPA Cloud Phone để kiểm tra trạng thái chạy:

curl -X POST "http://127.0.0.1:40000/api/cloudphone/rpa/task/page" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pageNo": 1,
    "pageSize": 20,
    "taskName": "Upload video from Cloud Storage"
  }'

Điểm then chốt là tác vụ RPA nhận videoDownloadUrl dưới dạng morelogin://cloudfile?ids=.... MoreLogin phân giải tệp từ Cloud Storage lúc chạy, nên phần tích hợp của bạn không cần host tệp trên URL công khai.

Thẻ là metadata dùng lại được cho các tệp cloud storage. Một tệp có thể có nhiều thẻ.

• Dùng Tạo thẻ tệp cloud storage để tạo các thẻ như Invoices, APK, Customer A hoặc RPA Assets.
• Dùng Đặt thẻ cho tệp khi bạn muốn ghi đè toàn bộ thẻ của một tệp.
• Dùng Thêm thẻ cho tệp khi bạn muốn thêm mà không xóa các thẻ hiện có.
• Dùng Truy vấn toàn bộ thẻ tệp cloud storage để dựng bộ lọc thẻ trong giao diện của bạn.
• Dùng Truy vấn thẻ của tệp để hiển thị những thẻ nào đang gắn với các tệp đã chọn.

Ví dụ: thêm một thẻ vào tệp mà không xóa các thẻ nó đang có.

curl -X POST "https://api.morelogin.com/cloudstorage/file/tag/add" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": 1800000000001001,
    "tagIds": [1800000000000103]
  }'

Lưu ý: đường dẫn Local API dùng tiền tố /api/. Đường dẫn Open API thì không.