/service/@id/uptime/monitorsTạo monitor
Body JSON: tên, chu kỳ, vị trí dò và settings theo loại monitor. Tino Uptime chạy lượt kiểm đầu ngay và chờ tối đa 10 giây: kết quả ở first_check (status: pending khi quá hạn). Monitor heartbeat có settings.ping_url chỉ trong câu trả lời này. HTTP 201. Vượt hạn mức gói (số monitor, chu kỳ, vị trí) trả 403 entitlement_exceeded; đích nội bộ hoặc không an toàn trả 422 validation_failed (details.reason: blocked_destination); đích đang bị kiểm quá dày trả 422 target_rate_exceeded.
Route của dịch vụ Tino Uptime: gọi bằng token đăng nhập của chủ dịch vụ; gateway /v1 (token ứng dụng, token cá nhân) chưa mở Tino Uptime. Xem Bắt đầu với Tino Uptime.
Xác thực
Gửi token trong header Authorization:
Authorization: Bearer <token>
Token gọi được: token đăng nhập của chủ dịch vụ Tino Uptime (token khu vực khách hàng tino.vn).
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ụ Tino Uptime |
Body (JSON)
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
name | string | Bắt buộc | Tên monitor, 1–200 ký tự |
interval_s | int | Bắt buộc | Chu kỳ kiểm (giây), 30–86400, không dưới `limits.min_interval_s` của gói |
locations | array | Tuỳ chọn | Vị trí dò, tối đa 10, trong `limits.locations` của gói (`vn-cmc`, `vn-vt`, `intl`) |
settings | object | Bắt buộc | Loại và đích kiểm: `type` là `http`, `keyword`, `ssl`, `domain`, `ping`, `tcp`, `dns` hoặc `heartbeat`, trường theo loại ở [Bắt đầu với Tino Uptime](/docs/uptime-start#loai-monitor) |
international_critical | boolean | Tuỳ chọn | `true`: chỉ điểm dò quốc tế lỗi cũng tính là down; mặc định `false` |
idempotency_key | string | Tuỳ chọn | 8–128 ký tự `A-Za-z0-9._:-`: gửi lại cùng khoá và cùng body thì không tạo thêm |
Phản hồi
Mẫu dựng theo OpenAPI của Tino Uptime (Tino chuyển tiếp nguyên câu trả lời trong data), giá trị là ví dụ.
Mã lỗi
| Mã lỗi | Mô tả |
|---|---|
404 · service_not_found, invalid method | Dịch vụ không phải của tài khoản đang đăng nhập, hoặc không phải Tino Uptime. |
404 · service_not_linked | Dịch vụ không còn là gói Tino Uptime đang dùng của khách. |
403 · account_suspended | Tài khoản Tino Uptime đang tạm ngưng: chặn thao tác ghi, GET vẫn dùng được. |
403 · entitlement_exceeded | Vượt hạn mức của gói; details.resource chỉ hạn mức. |
422 · validation_failed | Dữ liệu sai; details.field chỉ trường. |
502 · network, invalid_response | Kết nối giữa Tino và Tino Uptime gián đoạn: lỗi phía Tino, không phải lỗi token. Thử lại sau. |
Lỗi có dạng {"error": ["<CODE>"], "message", "details", "request_id"}; mọi mã lỗi ở Bắt đầu với Tino Uptime.