POST Khởi tạo Upload File
Khởi tạo Upload File Scope yêu cầu: seller.customer_servicehoặc creator.video.write Để upload một file lớn lên TikTok Shop (ví dụ: một video), hãy làm theo ba bước sau:
- Khởi tạo phiên upload cho video.
- Upload file video lên server TTS. Các file nhỏ hơn 5 MB phải được upload trong một request đơn lẻ, không chia chunk.
- Gọi API tương ứng với target path và truyền ResourceId được trả về ở bước 2 làm tham số.
Để biết thêm nội dung chi tiết, hãy tham khảo tài liệu:https://partner.tiktokshop.com/docv2/page/wfi3nz36
Phiên bản 202512
POST/open/202512/file/init
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Phụ thuộc vào loại xác thực của API. 1. Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token.2. Giá trị creator access_token từ Get Access Token, khi user_type = 1. Làm theo hướng dẫn này để lấy creator access_token.3. Giá trị partner access_token từ Get Access Token, khi user_type = 3. Làm theo hướng dẫn này để lấy partner access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| shop_cipher | string | Sử dụng property này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
| category_asset_cipher | string | Sử dụng property này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về định danh partner được dùng trong các API request. Lấy giá trị này bằng cách dùng Get Authorized Category Assets API. |
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các API request tới TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các API request. Nhà phát triển có thể dùng giá trị này để chuyển đổi sang thời gian địa phương. |
Body
| Properties | Type | Description |
|---|---|---|
| file_name Required | string | tên file |
| file_type Required | string | Các loại file được hỗ trợ. hiện chỉ hỗ trợ video |
| file_size Required | int | kích thước file, bytes |
| total_chunk_count Required | int | Tổng số chunk. |
| target_path Required | string | Sau khi video được upload, dùng interface này để gắn tài nguyên video vào material cụ thể |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong API response. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log của request |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | Empty. No business logic error codes. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext