модуль конфигурации сайта

В производственных средах следует использовать HTTPS, чтобы гарантировать токены аутентификации. HTTP рекомендуется только для сред разработки.

Управление конфигурацией системы с высшими полномочиями, доступное только root-пользователям. Содержит такие функции, как настройка глобальных параметров, сброс увеличения модели и миграция настроек консоли. Обновления конфигурации содержат строгую логику проверки зависимостей.

🔐 Корневая аутентификация

Получить глобальную конфигурацию

• Имя интерфейса: получить глобальную конфигурацию.
• Метод HTTP: GET
• Путь: /api/option/
• Требования аутентификации: root
• Введение в функцию: получение всех глобальных параметров конфигурации системы, фильтрация конфиденциальной информации, такой как токен, секрет, ключ и т. д. 💡Пример запроса:

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();

✅ Пример успешного ответа:

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

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось получить конфигурацию"
}

🧾 Описание поля:

data (массив): список элементов конфигурации option.go: 15-18

• data (строка): имя ключа элемента конфигурации.
• data (строка): значение элемента конфигурации, конфиденциальная информация отфильтрована option.go: 22-24

Обновить глобальную конфигурацию

• Имя интерфейса: обновить глобальную конфигурацию.
• Метод HTTP: PUT
• Путь: data
• Требования аутентификации: root
• Введение в функцию: обновление одного элемента глобальной конфигурации, включая проверку конфигурации и проверку зависимостей.

💡Пример запроса:

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();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "Обновление конфигурации выполнено успешно"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Невозможно включить GitHub OAuth，Пожалуйста, сначала заполните GitHub Client Id а также GitHub Client Secret！"
}

🧾 Описание поля:

• key (строка): имя ключа элемента конфигурации, обязательный параметр.go: 39-42
• key (любой тип): значение элемента конфигурации, поддерживает логические значения, числа, строки и другие типы option.go: 54-63.

Сбросить увеличение модели

• Имя интерфейса: сброс увеличения модели.
• Метод HTTP: POST
• Путь: key
• Требования аутентификации: root
• Введение в функцию: сбрасывает конфигурацию увеличения всех моделей на значения по умолчанию, которые используются для пакетного сброса цен на модели.

💡Пример запроса:

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();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "Увеличение модели успешно сброшено"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось сбросить масштаб модели."
}

🧾 Описание поля:

Параметры запроса отсутствуют, все конфигурации увеличения модели будут сброшены после выполнения.

Перенос устаревшей конфигурации консоли

• Имя интерфейса: перенос устаревшей конфигурации консоли.
• Метод HTTP: POST
• Путь: /api/option/migrate_console_setting
• Требования аутентификации: root
• Введение в функцию: перенос конфигурации консоли старой версии в новый формат конфигурации, включая информацию об API, объявления, часто задаваемые вопросы и т. д.

💡Пример запроса:

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();

✅ Пример успешного ответа:

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

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Миграция не удалась"
}

🧾 Описание поля:

• Нет параметров запроса
• Содержимое миграции включает в себя:
  • ApiInfo → console_setting.api_info
  • ApiInfo → console_setting.api_info
  • ApiInfo → console_setting.api_info
  • ApiInfo → console_setting.api_info