Tài Liệu API: Tải Lên Tệp TS lên TikTok

API này cho phép người dùng tải lên tệp .ts tới nền tảng quảng cáo TikTok bằng cách xử lý chúng thành tệp PNG 1px và xác thực qua cookie.

Thông Tin Cơ Bản

• Điểm Cuối: /upload.php (ví dụ: https://api.dulieuphim.ink/hongcam2002/upload.php)
• Phương Thức: POST
• Loại Nội Dung: multipart/form-data
• Định Dạng Phản Hồi: JSON

Tham Số Yêu Cầu

Tham Số	Kiểu	Bắt Buộc	Mô Tả	Ràng Buộc
api_key	Chuỗi	Có	Khóa API để xác thực.	Chính xác 32 ký tự, chữ và số.
aadvid	Chuỗi	Có	ID Nhà Quảng Cáo TikTok.	Chuỗi số (ví dụ: 123456789).
cookies	Chuỗi	Có	Chuỗi cookie để xác thực API TikTok.	Định dạng: key=value; key=value, phải chứa csrftoken.
ts_file	Tệp	Có	Tệp .ts cần tải lên.	Phải là tệp .ts, tối đa 10MB.

Định Dạng Phản Hồi

• success (Boolean): Cho biết tải lên thành công (true) hay thất bại (false).
• message (Chuỗi): Thông báo lỗi nếu success là false.
• url (Chuỗi): URL của tệp đã tải lên nếu success là true.

Ví Dụ Thành Công:

{
    "success": true,
    "url": "https://p16-ulike-sg.ibyteimg.com/obj/some-unique-id"
}
        

Ví Dụ Lỗi:

{
    "success": false,
    "message": "Lỗi: Khóa API không hợp lệ"
}
        

Ví Dụ Mã Nguồn

1. JavaScript (XMLHttpRequest - Được Sử Dụng Trong Biểu Mẫu Này)

Biểu mẫu trên sử dụng mã này để gửi yêu cầu:

const formData = new FormData();
formData.append('api_key', 'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6');
formData.append('aadvid', '123456789');
formData.append('cookies', 'sessionid=abc123; csrftoken=xyz789; user=john');
formData.append('ts_file', document.getElementById('ts_file').files[0]);

const xhr = new XMLHttpRequest();
xhr.open('POST', 'https://api.dulieuphim.ink/hongcam2002/upload.php', true);
xhr.onload = function() {
    if (xhr.status === 200) {
        const response = JSON.parse(xhr.responseText);
        console.log(response);
    }
};
xhr.send(formData);
        

2. PHP (cURL)

 $api_key,
    'aadvid' => $aadvid,
    'cookies' => $cookies,
    'ts_file' => new CURLFile($file_path, 'video/vnd.dlna.mpeg-tts', 'video.ts')
];

curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
        

Thông Báo Lỗi

• Lỗi: Chỉ cho phép yêu cầu POST!: Yêu cầu không phải POST.
• Lỗi: Khóa API là bắt buộc!: Thiếu hoặc rỗng api_key.
• Khóa API phải chính xác 32 ký tự: Độ dài api_key không hợp lệ.
• Khóa API không hợp lệ: api_key không tồn tại trong cơ sở dữ liệu.
• Giới hạn sử dụng khóa API đã vượt quá: api_key đã hết lượt sử dụng.
• Lỗi: Không có tệp nào được tải lên!: Thiếu ts_file.
• Lỗi: Vui lòng tải lên tệp .ts!: Tệp tải lên không phải .ts.
• Lỗi: Tệp vượt quá 10MB: Kích thước tệp vượt quá 10MB.
• Lỗi: ID Nhà Quảng Cáo (aadvid) là bắt buộc!: Thiếu hoặc rỗng aadvid.
• Lỗi: Định dạng aadvid không hợp lệ! Phải là chuỗi số.: aadvid chứa ký tự không phải số.
• Lỗi: Chuỗi cookie là bắt buộc!: Thiếu hoặc rỗng cookies.
• Lỗi: Định dạng chuỗi cookie không hợp lệ! Phải chứa các cặp key=value hợp lệ bao gồm csrftoken.: cookies không hợp lệ hoặc thiếu csrftoken.
• Lỗi: Tải lên TikTok thất bại.: Tải lên TikTok thất bại (bao gồm chi tiết).

Ghi Chú

• Thay https://api.dulieuphim.ink/hongcam2002/upload.php bằng URL điểm cuối thực tế của bạn nếu cần.
• Đảm bảo api_key hợp lệ và còn lượt sử dụng trong cơ sở dữ liệu.
• Chuỗi cookies phải chứa csrftoken hợp lệ từ phiên TikTok Ads.
• Đối với yêu cầu từ tên miền khác, thêm tiêu đề CORS vào tệp PHP:

  
  header('Access-Control-Allow-Origin: *');
  header('Access-Control-Allow-Methods: POST');
  header('Access-Control-Allow-Headers: Content-Type');
                  

Liên Hệ

Để giải quyết vấn đề về khóa API hoặc lỗi máy chủ, liên hệ với quản trị viên API hoặc kiểm tra nhật ký máy chủ. Tại đây