(59) Shoppable Video Precheck Tasks Result

资料正文

§1 (59) Shoppable Video Precheck Tasks Result

§2 Trigger scenario

Trigger scenario

The Video Precheck Result webhook is triggered when the Precheck Video Content API is called, and provides the results of the video’s quality assessment and violation checks.

§3 Data business parameters

Data business parameters

Parameter name	Data Type	Sample	Description
type	int	`59`	The ID of the webhook type.
tts_notification_id	string	`"7327112393057389710"`	The ID of the notification.
creator_open_id	string	`"VIyStQAAAADCBQ40s4TzODDSEIW-bM5O9cod3vK8OytW8m-bnBYlXw"`	The open_id of the creator. To get the value, see Authorization overview.
timestamp	int	`1644412885`	The UNIX timestamp when this webhook was triggered.
data	object
└task_id	string	`"7493990579714178574"`	ID of precheck task generated by TikTok Shop.
└violation_check_result	object
└└status	string	`SUCCESS`	Possible enumerations: `SUCCESS` `FAIL` `PROCESSING`
└└issues	[]object
└└└risk	string	`"HIGH"`	Risk type.
└└└suggestions	string	`"Your video may include unoriginal content. Creating original content is essential for standing out from the crowd."`	Suggestions on how to fix the risk.
└good_quality_check_result	object
└└status	string	`FAIL`	Possible enumerations: `SUCCESS` `FAIL` `PROCESSING`
└└issues	[]object
└└└code	string	`"LOW RESOLUTION"`	Quality check code.
└└└suggestions	string	`"Your video may include unoriginal content. Creating original content is essential for standing out from the crowd."`	How to improve video quality.

§4 Event example

Event example

{
  "type": 59,
  "creator_open_id": "VIyStQAAAADCBQ40s4TzOSSOEIW-bM5O9cod3vK8OytW8m-bnBYlXw",
  "tts_notification_id": "7327112393057371910",
  "timestamp": 1644412885,
  "data": {
    "task_id": "task_202402011200001234",
    "violation_check_result": {
      "status": "FAIL",
      "issues": [
        {
          "risk": "HIGH",
          "suggestions": "Remove prohibited visual elements and resubmit the video."
        }
      ]
    },
    "good_quality_check_result": {
      "status": "SUCCESS",
      "issues": [
        {
          "code": "LOW_RESOLUTION",
          "suggestions": "Consider uploading a higher-resolution video for better viewing experience."
        }
      ]
    }
  }
}