Tham chiếu · API máy chủ

/api/v1/blocklist

Đọc và ghi danh sách chặn từ hệ thống của bạn.

GET    /api/v1/blocklist
POST   /api/v1/blocklist
DELETE /api/v1/blocklist

Xác thực#

Token vận hành, qua header x-collect-token. Không phải khoá của site: đây là thao tác trên phạm vi rộng hơn một site.

Ghi phải là application/json. Yêu cầu đó chính là lớp chống CSRF. Nó buộc một request từ origin khác phải đi qua preflight mà không origin nào khác vượt qua.

Phạm vi#

Giống ba phạm vi trên Security: visitor, địa chỉ, phần cứng.

Trước khi ghi một mục phạm vi rộng, hệ thống đếm xem nó sẽ từ chối bao nhiêu người và từ chối hẳn giá trị đó nếu vượt giới hạn. Một hash tham số WebGL là một card đồ hoạ cộng một driver, tức là một dòng máy, và không có gì trong 32 ký tự hex nói cho bạn biết nó thuộc loại nào.

Mục chặn thuộc về workspace#

Mục chặn mang workspaceId và chỉ áp cho các site của workspace đó. Mục không có workspaceId là của người vận hành nền tảng và áp ở mọi nơi.

Nó được áp ở đâu#

Cả /api/v1/collect và /api/v1/verdict. Thứ tự kiểm tra: visitor, rồi phần cứng, rồi địa chỉ.

Mục chặn thuộc nhóm reason operator, nhóm duy nhất đứng trên mọi phép đo, vì đằng sau nó là một người đã quyết định.