POST
/v1/service/@id/waf/ip-rulesChặn hoặc cho phép IP
Body value (IP hoặc dải IP), action (chặn hoặc cho phép), note (không bắt buộc). Mục đã có thì trả HTTP 200 thay vì 201.
API v1 · Cập nhật 21/10/2026Xem .md
Gọi qua gateway https://api.tino.vn/v1 bằng token có quyền waf:write; xem Gọi API Tino.
Xác thực
Gửi token trong header Authorization:
Authorization: Bearer <token>
Token gọi được: token ứng dụng (tinoat_, Đăng nhập bằng Tino) hoặc token API cá nhân (tinopat_).
Scopes
waf:write
Tham số
Tham số đường dẫn
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
id | int | Bắt buộc | ID dịch vụ |
Body (JSON)
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
value | string | Bắt buộc | IP address or range (CIDR), e.g. `203.0.113.10` or `203.0.113.0/24`. |
action | string | Bắt buộc | `block` or `allow`. |
note | string | Tuỳ chọn | Note shown in the list. |
Phản hồi
Chưa có mẫu thật: route thay đổi dữ liệu thật hoặc tài khoản thử không có dữ liệu cho route này. Câu trả lời là một đối tượng JSON; lỗi theo dạng chung ở Gọi API Tino.
Mã lỗi
| Mã lỗi | Mô tả |
|---|---|
401 · invalid_token | Token sai, hết hạn hoặc đã bị thu hồi. |
403 · insufficient_scope | Token không có quyền waf:write. |
403 · ip_not_allowed | Token API cá nhân gọi từ IP ngoài danh sách giới hạn. |
Lỗi nghiệp vụ của route thường là HTTP 200 kèm {"error": ["<code>"]}; xem mã lỗi chung.