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

Cấu hình Script Hồ sơ

Trang này ghi lại các tham số cấu hình cho script profile được sử dụng trong quá trình tạo tác vụ.

Tổng quan​

Script profile được sử dụng để tự động cập nhật hồ sơ của tài khoản TikTok hoặc Instagram. Nó có thể cập nhật ảnh đại diện, biệt danh, tên người dùng, tiểu sử và URL liên kết.

Cấu hình Script (script_config)​

Đối tượng script_config chứa các tham số cho script hồ sơ. Dưới đây là các tham số có sẵn:

Tham số​

Tham sốKiểuBắt buộcMặc địnhMô tả
usernamestringKhông""Tên người dùng của tài khoản cần cập nhật hồ sơ. Được sử dụng ở chế độ theo thiết bị.
avatars_pathstringKhông""Đường dẫn đến thư mục chứa ảnh đại diện. Để trống để bỏ qua cập nhật ảnh đại diện.
nicknamestringKhông""Biệt danh đơn lẻ để đặt. Ưu tiên hơn nicknames.
nicknamesstringKhông""Nhiều biệt danh phân cách bằng dòng mới. Một biệt danh được chọn dựa trên profile_order.
username_tostringKhông""Tên người dùng mới để đặt. Ưu tiên hơn usernames.
usernamesstringKhông""Nhiều tên người dùng mới phân cách bằng dòng mới. Một tên được chọn dựa trên profile_order.
biostringKhông""Văn bản tiểu sử đơn lẻ để đặt. Ưu tiên hơn bios.
biosstringKhông""Nhiều văn bản tiểu sử phân cách bằng dòng mới. Một văn bản được chọn dựa trên profile_order.
link_urlstringKhông""URL liên kết đơn lẻ để đặt. Ưu tiên hơn link_urls.
link_urlsstringKhông""Nhiều URL liên kết phân cách bằng dòng mới. Một URL được chọn dựa trên profile_order.
profile_orderstringKhông"random"Cách chọn nội dung khi sử dụng các trường đa giá trị: random hoặc sequential.
job_countintegerKhông0Bộ đếm tác vụ dùng cho lựa chọn tuần tự. Được hệ thống tự động thiết lập.
ghi chú

Cần cung cấp ít nhất một trong các trường hồ sơ (avatar, nickname, username_to, bio, link_url). Nếu không, script sẽ chạy nhưng không thực hiện thay đổi nào.

Ví dụ​

Cập nhật Biệt danh​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "nickname": "My New Nickname"
    }
  }'

Cập nhật Tiểu sử và Liên kết​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "bio": "Check out my latest content!",
      "link_url": "https://example.com"
    }
  }'

Cập nhật Ảnh đại diện​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "avatars_path": "C:/avatars/"
    }
  }'

Cập nhật Nhiều Tài khoản với Biệt danh Khác nhau​

Sử dụng nicknames với profile_order: sequential để gán các biệt danh khác nhau cho từng tài khoản:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2", "device_serial_3"],
    "script_name": "profile",
    "script_config": {
      "nicknames": "Nickname One\nNickname Two\nNickname Three",
      "profile_order": "sequential",
      "bio": "Follow me for amazing content!"
    }
  }'

Cập nhật Hồ sơ theo Chế độ Tên người dùng​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@account1", "@account2"],
    "script_name": "profile",
    "script_config": {
      "nickname": "New Brand Name",
      "bio": "Updated bio for all accounts",
      "link_url": "https://mybrand.com"
    }
  }'

Lên lịch Cập nhật Hồ sơ​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "nickname": "Updated Nickname",
      "bio": "Fresh content every day!"
    },
    "start_time": "10:00"
  }'

Phản hồi​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [401, 402],
    "created_count": 2
  }
}

Thứ tự Hồ sơ​

Thứ tự Ngẫu nhiên (random)​

  • Chọn ngẫu nhiên một giá trị từ các trường đa giá trị (nicknames, bios, v.v.)
  • Hành vi mặc định

Thứ tự Tuần tự (sequential)​

  • Chọn các giá trị theo thứ tự dựa trên job_count
  • Tác vụ đầu tiên dùng giá trị đầu tiên, tác vụ thứ hai dùng giá trị thứ hai, v.v.
  • Quay lại từ đầu khi đến cuối danh sách
  • Phù hợp để gán các giá trị khác nhau cho các tài khoản khác nhau

Mã lỗi​

MãMô tả
40001Thiếu tham số bắt buộc
40003Script không được hỗ trợ qua API
40301Truy cập API yêu cầu gói Pro+

Xem thêm​