v2.media.init_video_upload
POST /api/v2/media/init_video_upload
Dùng API này để khởi tạo một tác vụ tải video mới và nhận ID phiên tải lên duy nhất.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/media/init_video_upload
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác được cấp sau khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| business | int32 | True | 3 | Xác định loại nghiệp vụ của video tải lên. Các giá trị hỗ trợ: 3 = Video |
| scene | int32 | True | 1 | Defines the purpose of the uploaded image under the specified business type. Supported values: - If business = 3 (Video): 1 = Shopee Video |
| file_name | string | True | test_video_name.mp4 | Tên tệp video gốc. |
| file_size | int64 | True | 26214400 | Total video file size in bytes. Rules and restrictions by business and scene: - If business = 3 (Video) and scene = 1 (Shopee Video): Maximum 1GB. |
| duration | int32 | True | 105 | Thời lượng video tính bằng giây. Rules and restrictions by business and scene: - If business = 3 (Video) and scene = 1 (Shopee Video): 1s~180s. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Cho biết loại lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| warning | string | Thông báo cảnh báo bạn cần lưu ý. | |
| request_id | string | e3e3e7f33ee88a7454c64e7a0b546e01 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| response | object | ||
| video_upload_id | string | sg-11110201-6kh48-mepm7a0ttcw3c3 | ID phiên tải lên duy nhất. |
| part_size | int64 | 10485760 | Kích thước mỗi phần. Khi tải video theo từng phần, video phải được chia theo kích thước phần này cho mỗi yêu cầu tải. |