video_upload_result_push

资料正文

§1 video_upload_result_push

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.

§2 Overview

Overview

Field	Value
Push code	38
Timeout (seconds)	3
Retry strategy (seconds)	300, 1800, 10800
Guaranteed delivery	No

§3 Push parameters

Push parameters

Name	Type	Sample	Description
data	object
data.video_upload_id	string	sg-11110201-6kh48-mepm7a0ttcw3c3	The unique ID of the upload task.
data.status	string	SUCCEEDED	Final status of the upload task. Possible values: - SUCCEEDED; - FAILED; - CANCELLED; Note: 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.
data.reason	string		Detailed fail or cancel reason, will be returned if status is FAILED or CANCELLED.
data.video_info	object		Transcoded video info, will be returned if status is SUCCEEDED.
data.video_info.video_url	string	http://play-src.vod.shopee.com/api/v4/11110201/mms/sg-11110201-6kh48-mepm7a0ttcw3c3.	Video playback URL.
data.video_info.video_thumbnail_url	string	http://img.sp.mms.shopee.sg/sg-11110201-6kh48-mepm7a0ttcw3c3_cover	Video thumbnail image URL.
data.video_info.thumbnail_width	int32	1920	Video thumbnail image width.
data.video_info.thumbnail_height	int32	1080	Video thumbnail image height.
data.video_info.duration	int32	105	Video duration in seconds.
data.video_info.resolution	string	960x540	Video resolution, e.g., "1280x1280".
data.update_time	timestamp	1758018336	The time of video status updates.
code	int32	38	Shopee's unique identifier for a push notification.
timestamp	timestamp	1758018336	Timestamp that indicates the message was sent.

§4 Sample

Sample

{
   "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
}

§5 Update log

Update log

Date	Change
2025-09-19	New Push