Blog Comment#
Worker đăng comment trên blog target + anchor backlink về website khách hàng.
Base URL: https://manager.likepion.com/api/v1/blog_comment
1. Lấy danh sách task #
curl -X GET 'https://manager.likepion.com/api/v1/blog_comment/links?limit=5' \
-H 'X-API-Key: <api_key>'| Param | Mặc định | Mô tả |
|---|---|---|
limit | 5 | Số task muốn pull (tối đa 1000) |
Response#
{
"success": true,
"data": [
{
"id": "a84f870f-98a0-4dcc-a839-38f35c5aa0ee",
"request_id": "9caeb282-b970-4931-a3e5-e215d5fb4cc1",
"domain": "target-blog.com",
"about": "Đoạn comment mẫu dài trên 30 ký tự...",
"website": "https://likepion.com",
"commenter_name": "John D.",
"email": "user@example.com"
}
]
}Giải thích fields#
| Field | Mô tả |
|---|---|
id | ID task — dùng khi gọi complete/fail |
request_id | ID request cha |
domain | Blog đích cần comment |
about | Nội dung comment (worker spin/random từ đây) |
website | Website khách hàng (anchor backlink trỏ về đây) |
commenter_name | Tên hiển thị khi comment |
email | Email điền vào form blog (nếu blog yêu cầu) |
2. Lấy chi tiết task #
Lấy thông tin 1 task cụ thể theo id. Không cần filter server/status. Không thay đổi DB.
curl -X GET 'https://manager.likepion.com/api/v1/blog_comment/links/TASK_ID' \
-H 'X-API-Key: <api_key>'Response#
Trả về 1 object (không bọc trong mảng) — schema giống bước 1.
{ "success": true, "data": { ...task fields... } }Nếu task không tồn tại hoặc đã soft-delete → HTTP 404 {"success": false, "message": "task not found"}.
3. Báo đang xử lý #
Sau khi pull task, bắt buộc gọi API này để chuyển task sang trạng thái running. Assign tự set started_at = NOW() (idempotent — gọi lại nhiều lần không đổi).
curl -X POST 'https://manager.likepion.com/api/v1/blog_comment/links/<task_id>/start' \
-H 'X-API-Key: <api_key>'Response#
{ "success": true }4. Báo hoàn thành #
curl -X POST 'https://manager.likepion.com/api/v1/blog_comment/links/<task_id>/complete' \
-H 'X-API-Key: <api_key>' \
-H 'Content-Type: application/json' \
-d '{
"link_post": "https://target-blog.com/post/seo-guide#comment-98765"
}'| Field | Bắt buộc | Mô tả |
|---|---|---|
link_post | ✔ | URL comment đã đăng (có #comment-<id> hoặc anchor) |
note | Ghi chú (tuỳ chọn) |
Response#
{ "success": true }5. Báo thất bại #
curl -X POST 'https://manager.likepion.com/api/v1/blog_comment/links/<task_id>/fail' \
-H 'X-API-Key: <api_key>' \
-H 'Content-Type: application/json' \
-d '{
"error_message": "blog closed comments"
}'| 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 }