REST API reference

Tích hợp mới theo hướng API-first

Thông báo: Bizfly Cloud dự kiến tạm ngừng dịch vụ VoD vào khoảng 31/12/2026. Không nên xây dựng tích hợp API VoD mới; hãy lên kế hoạch chuyển sang MPS. Lịch trình và hướng dẫn chuyển đổi chi tiết sẽ được thông báo riêng.

Với các tích hợp upload và quản lý media mới, Bizfly Cloud khuyến nghị sử dụng Media Processing System (MPS) . MPS cung cấp API công khai cho Basic upload và TUS, liệt kê file trong namespace, và liên kết file với client_reference. TUS resumable là phương thức được khuyến nghị cho upload production từ backend/worker; Direct TUS upload được khuyến nghị cho client của end user.

Với namespace liên kết VoD, chỉ file video upload qua MPS được đồng bộ và hiển thị trên dashboard VoD. Hình ảnh và các loại file khác chỉ được quản lý qua API MPS. Giá và hóa đơn tiếp tục theo cơ chế VoD cho đến khi Bizfly Cloud công bố pricing MPS riêng. Xem hướng dẫn MPS hoặc MPS Public API Reference .

Xác thực

BizflyCloud CDN API sử dụng các header X-Auth-Token và X-Tenant-Name để xác thực API

• Hướng dẫn lấy các thông tin X-Auth-Token và X-Tenant-Name: https://docs.bizflycloud.vn/api_cli/api_tutorials/#id=l%E1%BA%A5y-token

• Endpoint Api: https://manage.bizflycloud.vn/api/vod/

Khởi tạo kho video

POST https://manage.bizflycloud.vn/api/vod/stores

Request Body

|Name| Required | Type |Description| Example | |—-|———-|———|———–| |store_name| True | String |Tên của kho video|test| |player_sites| False | List | Sites được cho phép phát player|[“hoctructuyen.com”] |player_skin| True | String |Skin của player (skin1/skin2)|“skin1”|[“c1”, “c2”] |player_color_skin| True | String |Màu sắc của player|204848| |video_analytics_status| True | Boolean |tắt/bật video analytics |false| |drm_status| True | boolean |Trạng thái drm|false| |drm_allow_sites| False | List |Sites được DRM cho phép hiển thị|"*" |drm_allow_countries| False | List |Quốc gia được DRM cho phép|

Ví dụ

Request

curl --location --globoff 'https://manage.bizflycloud.vn/api/vod/stores' \
--header 'X-Tenant-Name: <tenant_name>' \
--header 'X-Auth-Token: <token>' \
--data '{
    "store_name": "name3",
    "player_sites": ["hoctructuyen.com"],
    "player_skin": "skin1",
    "player_color_skin": "rgb(29, 129, 39)",
    "video_analytics_status": false,
    "drm_status": false,
    "drm_allow_sites": ["allow site 1", "allow site 2"],
    "drm_allow_countries": ["c1", "c2"]
}'

Response

{
  "data": {},
  "description": "Successfull",
  "status": true,
  "status_code": "S001"
}

Lấy Token của kho video

POST https://manage.bizflycloud.vn/api/vod/store/qltns-channel/token?store_name=<store_name>

URI Parameters

Ví dụ

curl --location --globoff 'https://manage.bizflycloud.vn/api/vod/store/qltns-channel/token?store_name=test'