POST Upload File Init
Upload File Init Required scope: seller.customer_serviceor creator.video.write To upload a large file to Tiktok Shop (e.g., a video), follow these three steps:
- Initialize the upload session for the video.
- Upload the video file to the TTS server. Files smaller than 5 MB must be uploaded as a single, non‑chunked request.
- Call the API corresponding to the target path and pass the ResourceId returned in step 2 as a parameter.
For more detailed content, refer to the document:https://partner.tiktokshop.com/docv2/page/wfi3nz36
Version 202512
POST/open/202512/file/init
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | Depends on the auth type of the API. 1. The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token.2. The creator access_token value from Get Access Token, when user_type = 1. Follow this guide to get creator access_token.3. The partner access_token value from Get Access Token, when user_type = 3. Follow this guide to get partner access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| shop_cipher | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
| category_asset_cipher | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return The partner identifier used in API requests. Retrieve this value by using the Get Authorized Category Assets API. |
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
Body
| Properties | Type | Description |
|---|---|---|
| file_name Required | string | file name |
| file_type Required | string | Supported file types. current only support video |
| file_size Required | int | file size, bytes |
| total_chunk_count Required | int | The total number of chunks. |
| target_path Required | string | After the video is uploaded, use this interface to bind the video resource to the specific material |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | Empty. No business logic error codes. |
Is this content helpful?Helpful
Not Helpful
PreviousNext