Task API

Quản lý các tasks tự động hóa Facebook.

---

Get Tasks

Lấy danh sách tasks đang chờ xử lý.

GET /api/v1/task/get-process

Parameters

Param	Type	Default	Mô tả
_limit	number	10	Số lượng tasks tối đa
_server_id	string	-	Filter theo server

Request

curl -X GET "https://api.socialking.vn/api/v1/task/get-process?_limit=5" \
  -H "X-API-Key: your-api-key"

Response

{
  "success": true,
  "message": "Found 5 tasks",
  "tasks": [
    {
      "id": "019be8db-dc2f-7174-bdaa-d5b80f5ad8a0",
      "via_data": {
        "id": "100084198681477",
        "profile_id": "profile-abc123"
      },
      "network_params": {
        "proxy": {
          "ip": "192.168.1.100",
          "port": 8080
        }
      },
      "jobs": {
        "service_name": "post_group",
        "variables": {
          "group_id": "123456789",
          "text": "Nội dung bài đăng"
        }
      },
      "createdAt": "2025-01-24T10:00:00.000Z"
    }
  ]
}

---

Update Task

Cập nhật trạng thái task sau khi xử lý.

PUT /api/v1/task/update/:id

Parameters

Param	Type	Required	Mô tả
status	string	Yes	Trạng thái mới
result	object	No	Kết quả thực hiện
error	object	No	Chi tiết lỗi

Status Values

Status	Mô tả
completed	Hoàn thành
failed	Thất bại
running	Đang chạy
canceled	Đã hủy
retrying	Đang thử lại

Request

curl -X PUT "https://api.socialking.vn/api/v1/task/update/019be8db..." \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "completed",
    "result": {
      "post_id": "pfbid02abc123xyz"
    }
  }'

Response

{
  "success": true,
  "message": "Task updated successfully",
  "data": {
    "id": "019be8db-dc2f-7174-bdaa-d5b80f5ad8a0",
    "status": "completed",
    "updatedAt": "2025-01-24T12:30:00.000Z"
  }
}

---

Task Types

Action Tasks

Type	Mô tả
post_group	Đăng bài vào group
post_timeline	Đăng lên timeline
comment_post	Comment bài viết
react_post	React bài viết
share_post	Chia sẻ bài viết
send_message	Gửi tin nhắn
join_group	Tham gia group
add_friend	Kết bạn

Crawl Tasks

Type	Mô tả
get_news_feed	Lấy news feed
get_group_members	Lấy thành viên group
get_group_posts	Lấy bài viết group
get_post_comments	Lấy comments