(59) Shoppable Video Precheck Tasks Result

POST

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.

Authorizations

• webhookSignature

Request Body^required

Media typeapplication/json

object

type

required

The ID of the webhook type.

integer

Allowed value: 59

tts_notification_id

The ID of the notification.

string

creator_open_id

The open_id of the creator. To get the value, see Authorization overview.

string

timestamp

The UNIX timestamp when this webhook was triggered.

integer format: int64

data

object

task_id

ID of precheck task generated by TikTok Shop.

string

violation_check_result

object

status

Possible enumerations:
SUCCESS FAIL PROCESSING

string

Allowed values: SUCCESS FAIL PROCESSING

issues

Array<object>

object

risk

Risk type.

string

suggestions

Suggestions on how to fix the risk.

string

good_quality_check_result

object

status

Possible enumerations:
SUCCESS FAIL PROCESSING

string

Allowed values: SUCCESS FAIL PROCESSING

issues

Array<object>

object

code

Quality check code.

string

suggestions

How to improve video quality.

string

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."
        }
      ]
    }
  }
}

Responses

200

Return HTTP 200 to acknowledge receipt.