Mô-đun cấu hình trang web

Nên sử dụng HTTPS trong môi trường sản xuất để bảo mật mã thông báo xác thực. HTTP chỉ được khuyến nghị cho môi trường phát triển.

Đây là quản lý cấu hình hệ thống cấp cao nhất, chỉ người dùng Root mới có thể truy cập được. Nó bao gồm các tính năng như cấu hình tham số chung, đặt lại tỷ lệ mô hình và di chuyển cài đặt bảng điều khiển. Cập nhật cấu hình liên quan đến logic xác thực phụ thuộc nghiêm ngặt.

🔐 Xác thực gốc

Truy xuất cấu hình chung

• Tên giao diện: Truy xuất cấu hình chung
• Phương thức HTTP: NHẬN
• Đường dẫn: /api/option/
• Yêu cầu xác thực: Root
• Tóm tắt chức năng: Truy xuất tất cả các tùy chọn cấu hình chung cho hệ thống, lọc các thông tin nhạy cảm như Mã thông báo, Bí mật và Khóa. 💡 Yêu cầu Ví dụ:

const response = await fetch('/api/option/', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_root_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Ví dụ phản hồi thành công:

{
  "success": true,
  "message": "",
  "data": [
    {
      "key": "SystemName",
      "value": "88API"
    },
    {
      "key": "DisplayInCurrencyEnabled",
      "value": "true"
    },
    {
      "key": "QuotaPerUnit",
      "value": "500000"
    }
  ]
}

❗ Ví dụ về phản hồi thất bại:

{
  "success": false,
  "message": "Failed to retrieve configuration"
}

🧾 Mô tả trường:

data (Array): Danh sách các mục cấu hình option.go: 15-18

• key (String): Tên key của mục cấu hình
• value (String): Giá trị mục cấu hình; thông tin nhạy cảm đã được lọc option.go: 22-24

Cập nhật cấu hình toàn cầu

• Tên giao diện: Cập nhật cấu hình toàn cầu
• Phương thức HTTP: PUT
• Đường dẫn: /api/option/
• Yêu cầu xác thực: Root
• Tóm tắt chức năng: Cập nhật một mục cấu hình chung duy nhất, bao gồm kiểm tra xác thực cấu hình và kiểm tra phần phụ thuộc.

💡 Yêu cầu Ví dụ:

const response = await fetch('/api/option/', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_root_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    key: "SystemName",
    value: "My 88API System"
  })
});
const data = await response.json();

✅ Ví dụ phản hồi thành công:

{
  "success": true,
  "message": "Configuration updated successfully"
}

❗ Ví dụ về phản hồi thất bại:

{
  "success": false,
  "message": "Cannot enable GitHub OAuth. Please fill in the GitHub Client Id and GitHub Client Secret first!"
}

🧾 Mô tả trường:

• key (String): Tên key mục cấu hình, tùy chọn bắt buộc.go: 39-42
• value (Any Type): Giá trị mục cấu hình, hỗ trợ boolean, số, chuỗi và các loại khác option.go: 54-63

Đặt lại tỷ lệ mô hình

• Tên giao diện: Đặt lại tỷ lệ mô hình
• Phương thức HTTP: POST
• Đường dẫn: /api/option/rest_model_ratio
• Yêu cầu xác thực: Root
• Tóm tắt chức năng: Đặt lại cấu hình tỷ lệ cho tất cả các kiểu máy về giá trị mặc định của chúng, được sử dụng để đặt lại giá kiểu hàng loạt.

💡 Yêu cầu Ví dụ:

const response = await fetch('/api/option/rest_model_ratio', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_root_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Ví dụ phản hồi thành công:

{
  "success": true,
  "message": "Model ratios reset successfully"
}

❗ Ví dụ về phản hồi thất bại:

{
  "success": false,
  "message": "Failed to reset model ratios"
}

🧾 Mô tả trường:

Không có tham số yêu cầu. Việc thực thi sẽ thiết lập lại tất cả các cấu hình tỷ lệ mô hình.

Di chuyển cài đặt bảng điều khiển cũ

• Tên giao diện: Di chuyển cài đặt bảng điều khiển cũ
• Phương thức HTTP: POST
• Đường dẫn: /api/option/migrate_console_setting
• Yêu cầu xác thực: Root
• Tóm tắt chức năng: Di chuyển cài đặt bảng điều khiển phiên bản cũ sang định dạng cấu hình mới, bao gồm thông tin API, thông báo, Câu hỏi thường gặp, v.v.

💡 Yêu cầu Ví dụ:

const response = await fetch('/api/option/migrate_console_setting', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_root_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Ví dụ phản hồi thành công:

{
  "success": true,
  "message": "migrated"
}

❗ Ví dụ về phản hồi thất bại:

{
  "success": false,
  "message": "Migration failed"
}

🧾 Mô tả trường:

• Không có tham số yêu cầu
• Nội dung di chuyển bao gồm:
• ApiInfo → console_setting.api_info
• Announcements → console_setting.announcements
• FAQ → console_setting.faq
• UptimeKumaUrl/UptimeKumaSlug → console_setting.uptime_kuma_groups