video_upload_result_push

Last Updated: 6 Nov 2025

Thông số cơ bản

Property	Value
Category	Shopee Push
Push Mechanism Name	video_upload_result_push
Push Mechanism Code	38
Push Mechanism Description	Get notified immediately when a video upload reaches a final status (SUCCEEDED, FAILED, or CANCELLED). Intermediate status (INITIATED, UPLOADING, UPLOADED, PROCESSING) are not pushed to avoid unnecessary callbacks, can call v2.media.get_video_upload_result if need progress updates.
Push Mechanism Subscription Rules	ERP System/Seller In House System/Product Management/Customer Service/Consignment Service System/Shopee Video Management
Time Out Seconds	3s
Sequence Guaranteed	No
Can Repeated Same Message	Yes
Retry Seconds	300s,1800s,10800s

Tham số Push

Tên	Kiểu	Mẫu	Mô tả
data	object
video_upload_id	string	sg-11110201-6kh48-mepm7a0ttcw3c3	ID duy nhất của tác vụ tải lên.
status	string	SUCCEEDED	Trạng thái cuối cùng của tác vụ tải lên. Các giá trị có thể: - SUCCEEDED - FAILED - CANCELLED. Lưu ý: Trạng thái trung gian (INITIATED, UPLOADING, UPLOADED, PROCESSING) không được push để tránh callback không cần thiết, có thể gọi v2.media.get_video_upload_result nếu cần cập nhật tiến trình.
reason	string		Lý do thất bại hoặc hủy chi tiết, sẽ được trả về nếu trạng thái là FAILED hoặc CANCELLED.
video_info	object		Thông tin video đã mã hóa, sẽ được trả về nếu trạng thái là SUCCEEDED.
video_url	string	http://play-src.vod.shopee.com/api/v4/11110201/mms/sg-11110201-6kh48-mepm7a0ttcw3c3.	URL phát lại video.
video_thumbnail_url	string	http://img.sp.mms.shopee.sg/sg-11110201-6kh48-mepm7a0ttcw3c3\_cover	URL hình ảnh đại diện video.
thumbnail_width	int32	1920	Chiều rộng hình ảnh đại diện video.
thumbnail_height	int32	1080	Chiều cao hình ảnh đại diện video.
duration	int32	105	Thời lượng video tính bằng giây.
resolution	string	960x540	Độ phân giải video, ví dụ: "1280x1280".
update_time	timestamp	1758018336	Thời điểm cập nhật trạng thái video.
code	int32	38	Mã định danh duy nhất của Shopee cho một thông báo push.
timestamp	timestamp	1758018336	Thời điểm cho biết tin nhắn đã được gửi.

Json

{
   "data": {
       "status": "SUCCEEDED",
       "reason": "",
       "update_time": 1758018336,
       "video_info": {
           "video_url": "http://play-src.vod.shopee.com/api/v4/11110201/mms/sg-11110201-6kh48-mepm7a0ttcw3c3.",
           "video_thumbnail_url": "http://img.sp.mms.shopee.sg/sg-11110201-6kh48-mepm7a0ttcw3c3_cover",
           "thumbnail_width": 1920,
           "thumbnail_height": 1080,
           "duration": 105,
           "resolution": "960x540"
       }
   },
   "code": 37,
   "timestamp": 1758018336
}

Lịch sử cập nhật

Ngày	Chi tiết cập nhật
2025-09-19	New Push