Chuyển tới nội dung chính

Cấu hình Script Favorite

Trang này ghi lại các tham số cấu hình của script favorite.

Tổng quan​

Script favorite thêm bài đăng vào Favorites (trên TikTok) / Saved (trên Instagram). Với nhiều URL qua API, một tác vụ được tạo cho mỗi URL. Kiểm soát thời gian bằng start_time.

Bài đăng đã lưu sẽ bị bỏ qua

Script phát hiện bài đăng đã được lưu vào Yêu thích và bỏ qua chúng — nên chạy lại tác vụ sẽ không bỏ yêu thích bài đăng.

Cấu hình Script (script_config)​

Tham số cấu hình script favorite:

Tham số​

Tham sốKiểuBắt buộcMặc địnhMô tả
target_post_urlsstring[]Yes*[]Mảng URL bài đăng mục tiêu để lưu vào yêu thích (một tác vụ mỗi URL)
target_post_urlstringYes*""URL đơn lẻ hoặc nhiều URL phân cách bằng dòng mới/dấu phẩy
ghi chú

Phải cung cấp mảng target_post_urls hoặc chuỗi target_post_url. Nếu cả hai, target_post_urls được ưu tiên.

Tạo tác vụ

Với nhiều URL, API tạo một tác vụ cho mỗi URL. Ví dụ: 3 URL + 2 thiết bị = 6 tác vụ.

Ví dụ​

Lưu một bài đăng vào Yêu thích​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    }
  }'

Lưu nhiều bài đăng vào Yêu thích​

Một tác vụ cho mỗi bài đăng:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222",
        "https://www.tiktok.com/@user3/video/333"
      ]
    }
  }'

Tạo 3 tác vụ riêng biệt thực thi ngay lập tức.

Lên lịch Favorite với thời gian bắt đầu​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    },
    "start_time": "14:30"
  }'

Favorite theo danh sách tên người dùng​

Tạo tác vụ favorite trực tiếp cho các tài khoản cụ thể:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123"
    }
  }'

Ví dụ Instagram Save​

Trên Instagram, script favorite lưu bài đăng (bookmark):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/"
    }
  }'

Phản hồi​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [601, 602, 603],
    "created_count": 3
  }
}

Định dạng URL​

TikTok​

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram​

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

Threads​

https://www.threads.com/@username/post/ABCDEFGHIJK
https://www.threads.com/t/ABCDEFGHIJK

Các liên kết threads.net cũng hoạt động. Liên kết /share/ không hoạt động: mã của nó là một định danh khác với mã mà trang bài viết sử dụng, vì vậy nó bị từ chối thay vì được chuyển đổi thành URL không chỉ đến đâu cả.

Thực hành tốt nhất​

  1. Lên lịch tác vụ: Dùng start_time để phân tán hành động theo thời gian.

  2. Đa tài khoản: Bật enable_multi_account để lưu bài bằng nhiều tài khoản trên cùng thiết bị.

Mã lỗi​

CodeDescription
40001Thiếu URL bài đăng mục tiêu
40003Script không được hỗ trợ qua API
40301Yêu cầu gói Pro+

Xem thêm​