Entity — Connect#

Giai đoạn cuối cùng: Đăng nhập lại để gắn các link social (Twitter, Facebook, LinkedIn, YouTube) vào profile nhằm tăng độ trust và sức mạnh SEO cho Entity.

Base URL: https://manager.likepion.com/api/v1/entity

1. Lấy danh sách task #

curl -X GET 'https://manager.likepion.com/api/v1/entity/links?limit=5&status=connect' \
  -H 'X-API-Key: <api_key>'

Param	Mặc định	Mô tả
`limit`	5	Số task muốn pull (tối đa 1000)
`status`	—	Lọc theo trạng thái task (`connect`)

Response#

{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "request_id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
      "domain": "example-social.com",
      "website": "https://likepion.com",
      "email": "socuser@gmail.com",
      "username": "socuser01",
      "pass_mail": "xxxx xxxx xxxx xxxx",
      "twofa": "JBSWY3DPEHPK3PXP",
      "app_password": "xxxx xxxx xxxx xxxx",
      "password": "Abc123!@xyzQ",
      "entity_connect": [
        "https://entity-site-1.com/author/seouser01/",
        "https://entity-site-2.com/profile/seouser01",
        "https://entity-site-3.com/members/seouser01"
      ]
    }
  ]
}

Giải thích fields#

Field	Mô tả
`id`	ID task — dùng khi gọi start/complete/fail
`request_id`	ID request cha
`domain`	Site cần cập nhật liên kết
`website`	Website khách hàng
`email` / `username`	Email / username đăng nhập
`pass_mail` / `twofa` / `app_password`	Credentials Gmail + TOTP + app password
`password`	Mật khẩu tài khoản
`entity_connect`	Danh sách URL cần chèn vào profile. Assign tính dựa vào field `entity_connect` (jsonb) của request — xem bảng dưới

Logic tạo `entity_connect` (response)#

Assign đọc field entity_connect (jsonb) trên entity_request và compute thành array URL:

`entity_connect` (DB config)	Kết quả `entity_connect` (response)
`{"mode":"all"}`	Tất cả `link_profile` (không rỗng) của các task cùng `request_id`, order created_at ASC, max 150
`{"mode":"disable"}`	Không có phase connect — Assign mark request `completed` thẳng sau phase register
`{"mode":"limit","limit":4}`	Top N `link_profile` cùng request (N = `limit`)
`{"mode":"custom","link":["https://a","https://b"]}`	Dùng trực tiếp mảng URL trong `link`

2. Lấy chi tiết task #

Lấy thông tin 1 task theo id. Không thay đổi DB.

Query param	Bắt buộc	Mô tả
`status`		Verify task đang ở status mong đợi. Nếu task hiện KHÔNG ở status này → 404 (tránh worker xử lý nhầm phase).

curl -X GET 'https://manager.likepion.com/api/v1/entity/links/<task_id>?status=connect' \
  -H 'X-API-Key: <api_key>'

Response#

Trả về 1 object (không bọc trong mảng) — schema giống bước 1, gồm 11 field credentials + entity_connect.

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "request_id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
    "domain": "example-social.com",
    "website": "https://likepion.com",
    "email": "socuser@gmail.com",
    "username": "socuser01",
    "pass_mail": "xxxx xxxx xxxx xxxx",
    "twofa": "JBSWY3DPEHPK3PXP",
    "app_password": "xxxx xxxx xxxx xxxx",
    "password": "Abc123!@xyzQ",
    "entity_connect": [
      "https://entity-site-1.com/author/seouser01/",
      "https://entity-site-2.com/profile/seouser01",
      "https://entity-site-3.com/members/seouser01"
    ]
  }
}

Code	Response	Khi nào
404	`{"success": false, "message": "task not found"}`	Task không tồn tại / đã soft-delete
404	`{"success": false, "message": "task not in expected status", "current_status": "register", "expected": "connect"}`	Task tồn tại nhưng status không khớp `?status=`

3. Báo đang xử lý #

Sau khi pull task, bắt buộc gọi API này để chuyển task từ connect → connecting.

Trạng thái trước	Trạng thái sau
`connect`	`connecting`

Lưu ý: API chỉ chấp nhận task có status = connect. Task ở trạng thái khác sẽ bị từ chối.

curl -X POST 'https://manager.likepion.com/api/v1/entity/links/<task_id>/start' \
  -H 'X-API-Key: <api_key>'

Response#

{ "success": true }

4. Báo hoàn thành #

Báo connect thành công — task chuyển từ connecting → completed. Đây là bước cuối cùng của flow Entity.

Trạng thái trước	Trạng thái sau
`connecting`	`completed`

curl -X POST 'https://manager.likepion.com/api/v1/entity/links/<task_id>/complete' \
  -H 'X-API-Key: <api_key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "link_post": "https://example-site.com/profile/seouser01",
    "note": "All 4 social links updated successfully"
  }'

Field	Bắt buộc	Mô tả
`link_post`		URL profile đã cập nhật (nếu connect thay đổi URL hoặc cần xác nhận lại). Bỏ qua nếu link giữ nguyên từ phase register.
`link_profile`		Alias của `link_post` — gửi field nào cũng được, BE chấp nhận cả 2
`note`		Ghi chú (tuỳ chọn)

Response#

{ "success": true }

5. Báo thất bại #

Task chuyển từ connecting → connect_failed. Retry manager sẽ tự động re-queue nếu retry_count < max_retries.

Trạng thái trước	Trạng thái sau
`connecting`	`connect_failed`

curl -X POST 'https://manager.likepion.com/api/v1/entity/links/<task_id>/fail' \
  -H 'X-API-Key: <api_key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "error_message": "Profile is locked or restricted from editing"
  }'

Field	Bắt buộc	Mô tả
`error_message`	✔	Mô tả ngắn lỗi (≤1000 ký tự)
`note`		Ghi chú thêm

Response#

{ "success": true }

Entity — Connect#

1. Lấy danh sách task Test #

Response#

Giải thích fields#

Logic tạo entity_connect (response)#

2. Lấy chi tiết task Test #

Response#

3. Báo đang xử lý Test #

Response#

4. Báo hoàn thành Test #

Response#

5. Báo thất bại Test #

Response#

1. Lấy danh sách task #

Logic tạo `entity_connect` (response)#

2. Lấy chi tiết task #

3. Báo đang xử lý #

4. Báo hoàn thành #

5. Báo thất bại #