Tài liệu Tham khảo API

Tài liệu này cung cấp danh sách đầy đủ các API endpoint cho cả Hệ quản lý (Go) và Công cụ tự động hóa (Bun), được cập nhật chính xác theo cấu trúc router thực tế.

1. Quy ước Bảo mật (Middleware)

Hệ thống sử dụng các loại mã xác thực chính:

JWT (Bearer Token): Dùng cho Dashboard quản trị (Go /api/*). Yêu cầu header Authorization: Bearer <token>.

API Key (X-API-KEY): Dùng cho Client gửi nhiệm vụ (Go /search/*, /anchor-text/*). Yêu cầu header X-API-KEY: <key>.

Webhook Key (Authorization): Dùng xác thực giữa Tool và Backend (Go /webhook/*). Yêu cầu header Authorization: <WEBHOOK_KEY>.

2. Management API (Go)

Base URL: http://localhost:33003

Nhóm Xác thực & User

Đăng nhập: POST /api/user/login

Đăng ký (Public): POST /api/user/register

Danh sách User: GET /api/user/ (Phân trang), GET /api/user/get-all (Tất cả)

Profile cá nhân: GET /api/user/profile

Chi tiết User: GET /api/user/{id}

Cập nhật/Xóa: PUT /api/user/{id}, DELETE /api/user/{id}

Đổi mật khẩu: `PUT /api/user/change-password/{id}

Nhóm Server (Protected)

Danh sách/Tạo: GET /api/server/, POST /api/server/

Lấy tất cả: GET /api/server/get-all

Chi tiết/Cập nhật/Xóa: GET /api/server/{id}, PUT /api/server/{id}, DELETE /api/server/{id}

Nhóm Task (API Key)

Search Tasks:

Tạo mới (Bulk): POST /search/

Lấy danh sách: GET /search/get-all

Reset trạng thái: GET /search/reset-all-status

Anchor Text Tasks:

Tạo mới (Bulk): POST /anchor-text/search

Lấy danh sách: GET /anchor-text/get-all

Reset trạng thái: GET /anchor-text/reset-all-status

Nhóm Webhook (Webhook Key)

Lấy Proxy: POST /webhook/proxy/get-proxy, GET /webhook/proxy/get-proxy-can-rotate

Gửi kết quả: POST /webhook/update-search-result/{id}, POST /webhook/update-search-anchor-text/{id}

Kết quả rotate: POST /webhook/proxy-rotation-result/{id}

Kết quả v2: POST /webhook/keyword-result/{id}

3. Automation API (Bun)

Base URL: http://localhost:8080

Thông tin Server (Root)

Root Info: GET /

Health Check: GET /health

Logs: GET /logs?filePath=...

Automation Tasks (`/api/...`)

Searches:

GET /api/searches, POST /api/searches (Bulk Create), DELETE /api/searches

POST /api/searches/reset-status-all, POST /api/searches/reset-process-running

Anchor Texts:

GET /api/search-anchor-texts, POST /api/search-anchor-texts (Bulk Create), DELETE /api/search-anchor-texts

POST /api/search-anchor-texts/reset-status-all, POST /api/search-anchor-texts/reset-process-running

4. Nhật ký & Hệ thống (Go)

Activity Log: GET /api/activity-log

Update Search Data: PUT /api/keyword-result/update-search-data/{id}

Test Webhook: POST /test/webhook

Tài liệu Tham khảo API

1. Quy ước Bảo mật (Middleware)#

2. Management API (Go)#

Nhóm Xác thực & User#

Nhóm Server (Protected)#

Nhóm Task (API Key)#

Nhóm Webhook (Webhook Key)#

3. Automation API (Bun)#

Thông tin Server (Root)#

Automation Tasks (/api/...)#

4. Nhật ký & Hệ thống (Go)#