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/

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​