Action History API¶

Tạo lịch sử hành động cho tài khoản Facebook.

Create Action History¶

POST /api/v1/account/action-history/:id

Path Parameters¶

Param	Type	Mô tả
`id`	string	Account ID (UUID) hoặc Facebook UID

Request¶

{
  "actionType": "post_timeline",
  "status": "success",
  "note": "Đăng bài thành công",
  "performedAt": "2026-02-04T10:30:00.000Z"
}

Response¶

{
  "success": true,
  "message": "Tạo lịch sử hành động thành công",
  "data": {
    "id": "a0dee655-e7c5-4eb5-8796-a6c85a7ced46",
    "fbAccountId": "019b5989-99ee-70f2-86c5-ebea26b8da22",
    "fbAccountUid": "100090871226114",
    "actionType": "post_timeline",
    "targetType": null,
    "targetId": null,
    "status": "success",
    "performedAt": "2026-02-04T10:30:00.000Z",
    "nextAvailableAt": null
  }
}

Body Parameters¶

Param	Type	Required	Mô tả
`actionType`	string	No	Loại hành động: `post_timeline`, `post_group`, `comment_post`...
`targetType`	string	No	Loại đối tượng: `group`, `post`, `page`, `user`...
`targetId`	string	No	ID của đối tượng
`status`	string	No	`success`, `failed`, `pending`, `deleted`. Default: `success`
`note`	string	No	Ghi chú
`performedAt`	string	No	Thời điểm thực hiện (ISO datetime). Default: now()

Errors¶

404 - Không tìm thấy tài khoản:

{
  "success": false,
  "message": "Không tìm thấy tài khoản",
  "code": "ACCOUNT_NOT_FOUND"
}

409 - Hành động trùng lặp:

{
  "success": false,
  "message": "Hành động này đã được thực hiện trước đó",
  "code": "DUPLICATE_ACTION"
}