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

Cấu hình Script Đăng nhập

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

Tổng quan​

Script login được sử dụng để tự động đăng nhập vào tài khoản TikTok, Instagram hoặc Threads trên thiết bị. Nó điều hướng đến trang đăng nhập và nhập thông tin xác thực được lưu trữ trong TikMatrix cho tài khoản đã cho.

Yêu cầu thông tin đăng nhập tài khoản

Trước khi sử dụng script này qua API, hãy đảm bảo tên người dùng và mật khẩu của tài khoản đã được lưu trữ trong phần quản lý tài khoản của TikMatrix.

Threads

Trên Threads, script tiếp cận biểu mẫu đăng nhập theo bất kỳ cách nào thiết bị đang mở: hàng Add profile của bộ chuyển đổi tài khoản, màn hình đăng nhập hiện ra khi đã đăng xuất, hoặc một biểu mẫu vốn đã hiển thị sẵn. Nếu tài khoản đã có trên thiết bị, nó được đặt làm tài khoản hoạt động và trang hồ sơ được đọc lại để xác nhận.

Thiết bị đã đăng xuất vẫn được hỗ trợ. Khi màn hình đó đề nghị đăng nhập lại chính tài khoản bạn yêu cầu, script sẽ chọn cách đó — không phải nhập mật khẩu và không cần mã xác thực hai bước. Nếu không, script mở biểu mẫu và đăng nhập như bình thường.

Điều vẫn chưa được hỗ trợ là một tài khoản Instagram chưa từng có hồ sơ Threads. Threads sẽ hiển thị cho tài khoản đó luồng tạo hồ sơ, và script sẽ không nhấp qua các lựa chọn ấy thay bạn. Hãy thêm tài khoản đó bằng tay một lần; sau đó login sẽ xử lý nó như mọi tài khoản khác.

Cấu hình Script (script_config)​

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

Tham số​

Tham sốKiểuBắt buộcMặc địnhMô tả
usernamestringCó""Tên người dùng của tài khoản cần đăng nhập. Phải khớp với tài khoản được lưu trữ trong TikMatrix.

Ví dụ​

Đăng nhập theo Serial Thiết bị​

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

Đăng nhập theo Tên người dùng​

Sử dụng chế độ tên người dùng để tạo tác vụ đăng nhập cho một tài khoản cụ thể:

curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"usernames": ["@my_tiktok_account"],
"script_name": "login",
"script_config": {
"username": "@my_tiktok_account"
}
}'

Đăng nhập với Thời gian Bắt đầu theo Lịch​

curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "login",
"script_config": {
"username": "@my_tiktok_account"
},
"start_time": "09:00"
}'

Đăng nhập Nhiều Tài khoản trên Nhiều Thiết bị​

curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"usernames": ["@account1", "@account2", "@account3"],
"script_name": "login",
"script_config": {}
}'
ghi chú

Ở chế độ tên người dùng, hệ thống tự động tra cứu từng tài khoản và thiết bị liên kết của nó. username trong script_config là tùy chọn khi sử dụng chế độ tên người dùng, vì hệ thống sử dụng tên người dùng từ danh sách usernames.

Mọi tác vụ đăng nhập đều cần một tài khoản

login đăng nhập một tài khoản đã lưu, nên tác vụ không chỉ định tài khoản sẽ không thể chạy. Ở chế độ thiết bị, hãy chỉ định tài khoản trong script_config.username, hoặc đặt enable_multi_account để mở rộng yêu cầu theo các tài khoản đã liên kết với từng thiết bị. Thiết bị không có tài khoản nào liên kết và không được cung cấp username sẽ bị từ chối với mã 40007 — không tác vụ nào được tạo cho bất kỳ thiết bị nào trong yêu cầu đó.

Phản hồi​

{
"code": 0,
"message": "success",
"data": {
"task_ids": [201],
"created_count": 1
}
}

Mã lỗi​

MãMô tả
40001Thiếu tham số bắt buộc
40003Script không được hỗ trợ qua API
40007Thiết bị chưa liên kết tài khoản nào và cũng không có tài khoản nào được chỉ định
40301Truy cập API yêu cầu gói Pro+

Xem thêm​