🔒 Tài liệu Tính Năng Chưa có UI (Hidden Features)

File: App\Http\Controllers\Api\ManualSessionAPIController.php
Function: exportExcelManualSessionHistoryDomain

1. Export Excel Manual Session History — `is_get_domain_type`

Endpoint

GET /export/manual-session-history-domain

Mô tả

Tham số is_get_domain_type chỉ có hiệu lực khi type=CHECK.
Khi được bật, file Excel xuất ra sẽ thêm cột "Phân loại" (domain_type) ngay sau cột "Domain name".

Bối cảnh nghiệp vụ

💡 Hiểu rõ phần này để biết khi nào có dữ liệu phân loại và tại sao cần dùng tham số ẩn này.

Khi người dùng sử dụng tính năng "Kiểm Tra Thủ Công → Check Domain B" (tab đầu tiên trong màn hình Kiểm Tra Thủ Công):

Kiểm tra song song trên 8 mạng ISP (VNPT, FPT, Viettel, SCTV, Viettel 4G, Mobi 4G, Vina 4G, VNMB 4G)

Đồng thời nhận diện phân loại domain — xác định domain thuộc loại gì:

mainsite — Website chính thức (game, betting, v.v.)

satellite — Trang vệ tinh / landing page trỏ về mainsite

unknown — Không xác định được

Kết quả phân loại này được lưu vào field domain_type trong result của từng bản ghi history domain, nhưng không hiển thị trên giao diện web.

Cách hiện tại để lấy dữ liệu domain_type ra ngoài là dùng API export ẩn với is_get_domain_type=true — khi đó file Excel sẽ xuất thêm cột "Phân loại" chứa giá trị này.

Luồng dữ liệu:
  Check Domain B chạy
      └─► Kiểm tra 8 ISP + Nhận diện domain_type
              └─► Lưu vào result['domain_type']
                      └─► Chỉ lấy được qua export ẩn (is_get_domain_type=true)

Tham số ẩn

Tham số	Vị trí	Kiểu	Bắt buộc	Mặc định	Mô tả
`is_get_domain_type`	`query`	`boolean`	Không	`false`	Hiển thị cột Phân loại (domain_type) trong file Excel export

Cách sử dụng

Ví dụ curl thực tế (production)

Các query param kết hợp trong ví dụ trên:
Param Giá trị Ghi chú
manual_sessions_id 21080 ID của session cần export
type CHECK Bắt buộc phải là CHECK để is_get_domain_type có hiệu lực
export_all true Export toàn bộ (không lọc theo status_domain = DEFAULT)
block_label_type (rỗng) Không lọc theo block label
is_get_domain_type true Tính năng ẩn — thêm cột "Phân loại" vào file Excel

Param	Giá trị	Ghi chú
`manual_sessions_id`	`21080`	ID của session cần export
`type`	`CHECK`	Bắt buộc phải là `CHECK` để `is_get_domain_type` có hiệu lực
`export_all`	`true`	Export toàn bộ (không lọc theo `status_domain = DEFAULT`)
`block_label_type`	(rỗng)	Không lọc theo block label
`is_get_domain_type`	`true`	Tính năng ẩn — thêm cột "Phân loại" vào file Excel

Ảnh hưởng lên file Excel

Khi `is_get_domain_type=false` (mặc định)

Cột	Header
A	Domain name
B	Trạng thái
C	Trạng thái chặn
D → ...	Proxy providers (theo thứ tự sort)
Cuối	Thời gian kiểm tra

Khi `is_get_domain_type=true`

Cột	Header
A	Domain name
B	Phân loại ← cột mới được chèn vào
C	Trạng thái
D	Trạng thái chặn
E → ...	Proxy providers (theo thứ tự sort)
Cuối	Thời gian kiểm tra

Giá trị cột "Phân loại" lấy từ result['domain_type'] trong bảng manual_session_history_domains.
Các giá trị có thể là: mainsite, satellite, unknown (hoặc rỗng nếu chưa được phân loại).

Lưu ý

Tham số chỉ hoạt động với type=CHECK, không có tác dụng với type=RECORD hay type=CAPTURE.

Giá trị is_get_domain_type được parse bằng FILTER_VALIDATE_BOOLEAN, hỗ trợ: true, 1, "true", "on", "yes".

Nếu domain chưa được chạy classify, cột "Phân loại" sẽ để trống ('').

Nhận diện Mainsite/Satellite

🔒 Tài liệu Tính Năng Chưa có UI (Hidden Features)#

1. Export Excel Manual Session History — is_get_domain_type#

Endpoint#

Mô tả#

Bối cảnh nghiệp vụ#

Tham số ẩn#

Cách sử dụng#

Ví dụ curl thực tế (production)#

Ảnh hưởng lên file Excel#

Khi is_get_domain_type=false (mặc định)#

Khi is_get_domain_type=true#

Lưu ý#