Facebook Target API#
API quản lý target Facebook: tạo, cập nhật, xóa, khôi phục target cho automation.
Base URL: https://app.socialking.vn/api/v1
1. Tạo Target#
POST /social/fb/target/create
#
Auth: Bearer Token (JWT)
Request Body:
{
"name": "Target nhóm Facebook",
"type": "group",
"description": "Target các nhóm mua bán",
"target_data": [
{
"facebook_id": "123456789",
"name": "Nhóm mua bán HN",
"url": "https://facebook.com/groups/123456789"
}
]
}| Field | Type | Required | Validation |
|---|---|---|---|
name | string | Yes | 1-255 ký tự |
type | FbTargetType | Yes | Enum target type |
description | string | No | Max 1000 ký tự |
status | string | No | Default draft |
target_data | array | No | Danh sách target data |
target_data[].facebook_id | string | Yes | Facebook ID |
target_data[].name | string | No | Max 255 ký tự |
target_data[].url | string | No | URL Facebook |
target_data[].note | string | No | Max 1000 ký tự |
target_data[].status | string | No | Default draft |
Response (201):
{
"success": true,
"data": {
"id": "uuid-string",
"name": "Target nhóm Facebook",
"type": "group",
"description": "Target các nhóm mua bán",
"status": "draft",
"target_data": [...]
}
}2. Danh sách Target#
GET /social/fb/target/get-all
#
Auth: Bearer Token (JWT)
Query Parameters:
| Param | Type | Default | Mô tả |
|---|---|---|---|
_page | number | 1 | Trang |
_limit | number | 20 | Items/trang |
_order | string | desc | asc | desc |
_sort | string | - | Field sắp xếp |
_search | string | - | Tìm kiếm |
Response (200):
{
"success": true,
"data": {
"targets": [...],
"total": 15,
"page": 1
}
}3. Target gần đây#
GET /social/fb/target/recent
#
Auth: Bearer Token (JWT)
Query Parameters:
| Param | Type | Default | Mô tả |
|---|---|---|---|
limit | number | 10 | Số lượng |
4. Target cho Picker#
GET /social/fb/target/get-all/picker
#
Auth: Bearer Token (JWT)
Response (200): Danh sách target dạng select/picker widget.
5. Chi tiết Target#
GET /social/fb/target/get-by-id/:targetId
#
Auth: Bearer Token (JWT)
URL Params: targetId (UUID)
6. Cập nhật Target#
PUT /social/fb/target/update/:targetId
#
Auth: Bearer Token (JWT)
URL Params: targetId (UUID)
Request Body: Các fields giống tạo target, tất cả optional.
7. Cập nhật Status hàng loạt#
PATCH /social/fb/target/update-status
#
Auth: Bearer Token (JWT)
Request Body:
{
"targetIds": ["uuid-1", "uuid-2"],
"status": "active"
}8. Xóa mềm Target#
POST /social/fb/target/soft-delete
#
Auth: Bearer Token (JWT)
Request Body:
{
"targetIds": ["uuid-1", "uuid-2"]
}9. Khôi phục Target#
POST /social/fb/target/restore
#
Auth: Bearer Token (JWT)
10. Xóa vĩnh viễn Target#
POST /social/fb/target/hard-delete
#
Auth: Bearer Token (JWT)
11. Xóa Cache#
POST /social/fb/target/clear-cache
#
Auth: Bearer Token (JWT)
Rate Limit: 10 req/sec