/service/@id/uptime/channelsTạo kênh cảnh báo
Kênh mới chờ xác minh, trừ email tới đúng địa chỉ đã xác minh của chủ tài khoản. verification.method cho biết bước tiếp: email_code (mã trong thư, hiệu lực 24 giờ), telegram_link (mở telegram_url trong 10 phút), test_message (Discord, Slack, webhook: gọi xác minh kênh để gửi tin thử), zalo_link, zalo_otp. Kênh webhook trả webhook_secret (whsec_…) chỉ một lần. HTTP 201. Loại kênh ngoài limits.channels của gói trả 403 entitlement_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ả |
|---|---|---|---|
kind | string | Bắt buộc | `email`, `telegram`, `discord`, `slack`, `webhook` hoặc `zalo`, trong `limits.channels` của gói |
name | string | Bắt buộc | Tên kênh, 1–100 ký tự |
config | object | Tuỳ chọn | `address` cho email; `url` (https) cho Discord, Slack, webhook; Zalo: `consent: true` và `phone` (số di động, xác minh bằng OTP) hoặc bỏ `phone` để liên kết qua OA; Telegram không cần |
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.