TikTok Shop: Upload Tệp Ảnh

API cho phép tải trực tiếp tệp ảnh vật lý từ máy chủ hoặc ứng dụng của bạn lên hệ thống lưu trữ CDN của TikTok, trả về đường dẫn URL công khai.

---

Thông Tin Endpoint

• Phương thức: POST
• Đường dẫn: /v1/tiktok/upload
• Định dạng dữ liệu: multipart/form-data
• Xác thực: Header X-API-Key (Yêu cầu quyền truy cập sàn tiktok)

---

1. Tham Số Form-Data

Tên trường	Kiểu dữ liệu	Bắt buộc	Giới hạn dung lượng	Định dạng hỗ trợ
file	binary	Bắt buộc	$\le$ 12MB	JPG, JPEG, PNG, WEBP

CAUTION

Giới hạn dung lượng 12MB: Nếu file upload vượt quá 12MB, Gateway sẽ ngắt kết nối và phản hồi mã lỗi 413 PAYLOAD_TOO_LARGE nhằm tối ưu băng thông và bộ nhớ. Hãy nén ảnh trước khi tải lên nếu cần.

---

2. Ví Dụ Upload Tệp

cURL

curl -X POST "https://api.yourdomain.com/v1/tiktok/upload" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/duong/dan/anh_san_pham.jpg"

Python

import httpx

API_KEY = "YOUR_API_KEY"
URL = "https://api.yourdomain.com/v1/tiktok/upload"

with open("anh_san_pham.jpg", "rb") as f:
    files = {"file": ("anh_san_pham.jpg", f, "image/jpeg")}
    headers = {"X-API-Key": API_KEY}
    response = httpx.post(URL, headers=headers, files=files, timeout=60.0)

print(response.json())

JavaScript / Node.js

import FormData from "form-data";
import fs from "fs";
import axios from "axios";

const form = new FormData();
form.append("file", fs.createReadStream("anh_san_pham.jpg"));

const response = await axios.post("https://api.yourdomain.com/v1/tiktok/upload", form, {
  headers: {
    ...form.getHeaders(),
    "X-API-Key": "YOUR_API_KEY"
  }
});

console.log(response.data);

---

3. Cấu Trúc Response Trả Về

Khi upload thành công (200 OK), máy chủ phản hồi URI nội bộ và URL ảnh công khai:

{
  "code": 0,
  "message": "success",
  "data": {
    "uri": "tos-maliva-i-o3syd03w52-us/9a8b7c6d5e4f1234567890abcdef.jpg",
    "url": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/9a8b7c6d5e4f1234567890abcdef.jpg"
  }
}

• uri: Mã đường dẫn định danh tệp trong kho lưu trữ của TikTok.
• url: Đường dẫn URL ảnh CDN công khai, có thể truy cập hoặc hiển thị trực tiếp trên trình duyệt.