Xác thực
Đăng nhập tạo cookie HttpOnly, SameSite=Lax; bật Secure khi chạy HTTPS. API chặn request thay đổi dữ liệu từ origin khác. Truyền X-Organization-ID để chọn tổ chức; backend kiểm tra membership/role trước transaction có RLS.
Tải OpenAPI tại /api/v1/openapi.json trên hệ thống của bạn. Lỗi JSON có trường error; lệnh tạo trả ID mới. Danh sách tối đa 200 phần tử; monitors/incidents/maintenances/pages/components/audit/deliveries hỗ trợ query offset.
Vai trò
Viewer đọc dữ liệu workspace. Operator quản lý monitor và công bố incident/bảo trì. Admin quản lý thành viên, probe, trang status, webhook. Owner kích hoạt domain. Platform admin là cờ riêng, chỉ cấp rõ ràng qua CLI.
Probe API
Probe dùng Bearer token riêng, không dùng browser session. POST /api/v1/probe/lease nhận tối đa 50 job với lease 45 giây. POST /api/v1/probe/results gửi tối đa 50 kết quả kèm job ID và lease token. Lease hết hạn có thể được cấp lại; gửi kết quả thành công trùng không tạo mẫu trùng.