пользовательский модуль
Описание функции
Префикс интерфейса: https://88api.ai
Интерфейсы, связанные с аккаунтом: регистрация и вход, личные данные, управление токенами, пополнение баланса и оплата, партнёрская программа. Поддерживаются 2FA, подтверждение электронной почты и несколько способов входа через OAuth.
Регистрация/вход в аккаунт
🔐 Аутентификация не требуется
Зарегистрируйте новый аккаунт
- Имя интерфейса: зарегистрируйте новую учетную запись.
- Метод HTTP: POST
- Путь:
/api/user/register - Требования аутентификации: общедоступно.
- Введение в функцию: создание новой учетной записи пользователя, поддержка функций проверки электронной почты и кода рекомендации.
💡Пример запроса:
const response = await fetch('/api/user/register', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
username: "newuser",
password: "password123",
email: "user@example.com",
verification_code: "123456",
aff_code: "INVITE123"
})
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "Регистрация пользователя прошла успешно"
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Администратор закрыл регистрацию нового пользователя"
}🧾 Описание поля:
username(строка): имя пользователя, обязательно.password(строка): требуется пароль.email(строка): адрес электронной почты, требуется, если включена проверка электронной почты.verification_code(строка): код подтверждения электронной почты, требуется, если включена проверка электронной почты.aff_code(строка): код рекомендации, необязательно.
Вход пользователя
- Имя интерфейса: Логин пользователя.
- Метод HTTP: POST
- Путь:
/api/user/login - Требования аутентификации: общедоступно.
- Введение в функцию: вход в учетную запись пользователя, поддержка двухэтапной проверки (2FA).
💡Пример запроса:
const response = await fetch('/api/user/login', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
username: "testuser",
password: "password123"
})
});
const data = await response.json();✅ Пример успешного ответа (без 2FA):
{
"success": true,
"message": "Вход успешен",
"data": {
"token": "user_access_token",
"user": {
"id": 1,
"username": "testuser",
"role": 1,
"quota": 1000000
}
}
}✅ Пример успешного ответа (требуется 2FA):
{
"success": true,
"message": "Пожалуйста, введите код двухэтапной проверки",
"data": {
"require_2fa": true
}
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Администратор отключил вход по паролю"
}🧾 Описание поля:
username(строка): имя пользователя, обязательно.password(строка): требуется пароль.require_2fa(логическое значение): требуется ли двухэтапная проверка.
Обратный вызов платежа Epay
- Имя интерфейса: обратный вызов платежа Epay.
- Метод HTTP: GET
- Путь:
/api/user/epay/notify - Требования аутентификации: общедоступно.
- Введение в функцию: обработка уведомлений об обратном платеже из системы EasyPay.
💡Пример запроса:
_// Обычно вызывается платёжной системой автоматически, вызывать вручную не нужно _
_// Пример URL: /api/user/epay/notify?trade_no=USR1NO123456&money=10.00&trade_status=TRADE_SUCCESS_✅ Пример успешного ответа:
{
"success": true,
"message": "Платеж успешен"
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Заказ не существует или был обработан"
}🧾 Описание поля:
trade_no(строка): номер заказа транзакции.money(строка): Сумма платежаtrade_status(строка): статус транзакции.sign(строка): проверка подписи
Список всех групп (неаутентифицированная версия)
- Имя интерфейса: список всех групп.
- Метод HTTP: GET
- Путь:
/api/user/groups - Требования аутентификации: общедоступно.
- Введение в функцию: получите всю информацию о группах пользователей в системе и получите к ней доступ без входа в систему.
💡Пример запроса:
const response = await fetch('/api/user/groups', {
method: 'GET',
headers: {
'Content-Type': 'application/json'
}
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "",
"data": {
"default": {
"ratio": 1.0,
"desc": "Группировка по умолчанию"
},
"vip": {
"ratio": 0.8,
"desc": "VIPГруппа"
},
"auto": {
"ratio": "автоматический",
"desc": "Автоматически выбирать лучшую группировку"
}
}
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Не удалось получить информацию о группе."
}🧾 Описание поля:
data (объект): отображение информации о группе.
- ключ (строка): имя группы
ratio(число/строка): увеличение группировки, «авто» означает автоматический выбор.desc(строка): описание группы.
🔐 Аутентификация пользователя
Выйти
- Имя интерфейса: выход из системы.
- Метод HTTP: GET
- Путь:
/api/user/logout - Требования аутентификации: Пользователь
- Введение в функцию: очистить сеанс пользователя и выйти из системы.
💡Пример запроса:
const response = await fetch('/api/user/logout', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
}
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": ""
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Очистка сеанса не удалась"
}🧾 Описание поля:
Нет параметров запроса
Собственная операция пользователя
🔐 Аутентификация пользователя
Узнайте, в какой группе вы состоите
- Имя интерфейса: узнайте группу, в которой вы находитесь.
- Метод HTTP: GET
- Путь:
/api/user/self/groups - Требования аутентификации: Пользователь
- Введение в функцию: получение информации о группировке, доступной текущему вошедшему в систему пользователю, включая увеличение и описание группировки.
💡Пример запроса:
const response = await fetch('/api/user/self/groups', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
}
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "",
"data": {
"default": {
"ratio": 1.0,
"desc": "Группировка по умолчанию"
},
"vip": {
"ratio": 0.8,
"desc": "VIPГруппа"
},
"auto": {
"ratio": "автоматический",
"desc": "Автоматически выбирать лучшую группировку"
}
}
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Не удалось получить информацию о группе."
}🧾 Описание поля:
data (объект): отображение информации о доступной пользователю группе
- ключ (строка): имя группы
ratio(число/строка): увеличение группировки, «автоматический» означает автоматический выбор оптимальной группировки.desc(строка): описание группы.
Получить личную информацию
- Имя интерфейса: получение личной информации.
- Метод HTTP: GET
- Путь:
/api/user/self - Требования аутентификации: Пользователь
- Введение в функцию: получение подробной информации о текущем пользователе, включая разрешения, квоты, настройки и т. д.
💡Пример запроса:
const response = await fetch('/api/user/self', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
}
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "",
"data": {
"id": 1,
"username": "testuser",
"display_name": "Test User",
"role": 1,
"status": 1,
"email": "user@example.com",
"group": "default",
"quota": 1000000,
"used_quota": 50000,
"request_count": 100,
"aff_code": "ABC123",
"aff_count": 5,
"aff_quota": 10000,
"aff_history_quota": 50000,
"inviter_id": 0,
"linux_do_id": "",
"setting": "{}",
"stripe_customer": "",
"sidebar_modules": "{\"chat\":{\"enabled\":true}}",
"permissions": {
"can_view_logs": true,
"can_manage_tokens": true
}
}
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Не удалось получить информацию о пользователе."
}🧾 Описание поля:
id(числовой): идентификатор пользователя.username(строка): имя пользователяdisplay_name(строка): отображаемое имя.role(номер): роль пользователя, для обычного пользователя — 1.status(номер): статус пользователя, 1 = нормально, 2 = отключеноemail(строка): адрес электронной почты.group(строка): группа, к которой он принадлежит.quota(число): общая квотаused_quota(число): использованная квота.request_count(число): количество запросов.aff_code(строка): код рекомендации.aff_count(число): количество рефералов.aff_quota(число): квота реферального вознагражденияaff_history_quota(число): историческая рекомендуемая квота.inviter_id(номер): идентификатор приглашающего.linux_do_id(строка): идентификатор учетной записи LinuxDo.setting(строка): строка JSON пользовательских настроек.stripe_customer(строка): идентификатор клиента Stripe.sidebar_modules(строка): строка JSON конфигурации модуля боковой панели.permissions(объект): информация о разрешениях пользователя.
Получите видимость модели
- Имя интерфейса: получение видимости модели.
- Метод HTTP: GET
- Путь:
/api/user/models - Требования аутентификации: Пользователь
- Введение в функцию: получение списка моделей ИИ, доступных текущему пользователю.
💡Пример запроса:
const response = await fetch('/api/user/models', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
}
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "",
"data": [
"gpt-5.5",
"claude-sonnet-5-5",
"gemini-3.5-flash",
"deepseek-v4-flash"
]
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Не удалось получить список моделей."
}🧾 Описание поля:
data (массив): список названий моделей, доступных пользователю.
Изменение личной информации
- Имя интерфейса: изменение личной информации.
- Метод HTTP: PUT
- Путь:
/api/user/self - Требования аутентификации: Пользователь
- Введение в функцию: обновление личной информации пользователя или настроек боковой панели.
💡 Пример запроса (обновление личной информации):
const response = await fetch('/api/user/self', {
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
display_name: "New Display Name",
email: "newemail@example.com"
})
});
const data = await response.json();💡 Пример запроса (обновление настроек боковой панели):
const response = await fetch('/api/user/self', {
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
sidebar_modules: JSON.stringify({
chat: { enabled: true, playground: true },
console: { enabled: true, token: true }
})
})
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "Обновление успешно выполнено"
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Ввод незаконен"
}🧾 Описание поля:
display_name(строка): отображаемое имя, необязательно.email(строка): адрес электронной почты, необязательно.password(строка): новый пароль, необязательно.sidebar_modules(строка): строка JSON конфигурации модуля боковой панели, необязательно.
Отменить учетную запись
- Имя интерфейса: выход из учетной записи.
- Метод HTTP: DELETE
- Путь:
/api/user/self - Требования аутентификации: Пользователь
- Введение в функцию: удаление текущей учетной записи пользователя.
💡Пример запроса:
const response = await fetch('/api/user/self', {
method: 'DELETE',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
}
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": ""
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Не могу удалить учетную запись суперадминистратора"
}🧾 Описание поля:
Нет параметров запроса
Создать токен доступа уровня пользователя
- Имя интерфейса: создать токен доступа на уровне пользователя.
- Метод HTTP: GET
- Путь:
/api/user/token - Требования аутентификации: Пользователь
- Введение в функцию: создание нового токена доступа для текущего пользователя для вызовов API.
💡Пример запроса:
const response = await fetch('/api/user/token', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
}
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "",
"data": "`<YOUR_API_KEY>`"
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Не удалось сгенерировать токен"
}🧾 Описание поля:
data (строка): созданный токен доступа.
Получите информацию о промокоде
- Имя интерфейса: получение информации о промокоде.
- Метод HTTP: GET
- Путь:
/api/user/aff - Требования аутентификации: Пользователь
- Введение в функцию: получите или сгенерируйте промокод пользователя, который используется для приглашения новых пользователей зарегистрироваться.
💡Пример запроса:
const response = await fetch('/api/user/aff', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
}
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "",
"data": "ABC123"
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Не удалось получить промокод"
}🧾 Описание поля:
data (строка): промокод пользователя. Если он не существует, автоматически будет сгенерирована случайная строка из 4 цифр.
Прямое пополнение баланса
- Название интерфейса: прямое пополнение баланса.
- Метод HTTP: POST
- Путь:
/api/user/topup - Требования аутентификации: Пользователь
- Введение в функцию: используйте код погашения для пополнения квоты аккаунта.
💡Пример запроса:
const response = await fetch('/api/user/topup', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
key: "REDEEM123456"
})
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "Погашение успешно",
"data": 100000
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Код активации недействителен или уже использован."
}🧾 Описание поля:
key(строка): требуется код активации.data(число): возвращает сумму квоты, погашенную в случае успеха.
Отправьте платежное поручение
- Имя интерфейса: Отправить платежное поручение
- Метод HTTP: POST
- Путь:
/api/user/pay - Требования аутентификации: Пользователь
- Введение в функцию: создание онлайн-платежных поручений с поддержкой нескольких способов оплаты.
💡Пример запроса:
const response = await fetch('/api/user/pay', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
amount: 10000,
payment_method: "alipay",
top_up_code: ""
})
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "success",
"data": {
"pid": "12345",
"type": "alipay",
"out_trade_no": "USR1NO123456",
"notify_url": "https://example.com/notify",
"return_url": "https://example.com/return",
"name": "TUC10000",
"money": "10.00",
"sign": "abc123def456"
},
"url": "https://pay.example.com/submit"
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Сумма пополнения не может быть меньше 1000"
}🧾 Описание поля:
amount(число): сумма пополнения должна быть больше или равна минимальной сумме пополненияpayment_method(строка): способ оплаты, например «alipay», «wxpay» и т. д.top_up_code(строка): код пополнения, необязательно.data(объект): параметры формы оплаты.url(строка): адрес отправки платежа
Расчёт суммы платежа
- Имя интерфейса: расчёт суммы платежа.
- Метод HTTP: POST
- Путь:
/api/user/amount - Требования аутентификации: Пользователь
- Введение в функцию: расчет фактической суммы платежа, соответствующей указанной сумме пополнения счета.
💡Пример запроса:
const response = await fetch('/api/user/amount', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
amount: 10000,
top_up_code: ""
})
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "success",
"data": "10.00"
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Сумма пополнения не может быть меньше 1000"
}🧾 Описание поля:
amount(число): сумма пополнения должна быть больше или равна минимальной сумме пополнения.top_up_code(строка): код пополнения, необязательно.data(строка): фактическая сумма к оплате (юани)
Перевод рекламного кредита
- Название интерфейса: Перевод рекламного кредита.
- Метод HTTP: POST
- Путь:
/api/user/aff_transfer - Требования аутентификации: Пользователь
- Введение в функцию: конвертируйте сумму вознаграждения по акции в доступную квоту.
💡Пример запроса:
const response = await fetch('/api/user/aff_transfer', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
quota: 50000
})
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "Перенос успешен"
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "邀请额度不足!"
}🧾 Описание поля:
quota (число): сумма конвертируемой квоты должна быть больше или равна минимальной квоте единицы.
Обновить настройки пользователя
- Имя интерфейса: обновить настройки пользователя.
- Метод HTTP: PUT
- Путь:
/api/user/setting - Требования аутентификации: Пользователь
- Введение в функцию: обновление конфигурации личных настроек пользователя.
💡Пример запроса:
const response = await fetch('/api/user/setting', {
method: 'PUT',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_user_token',
'New-Api-User': 'your_user_id'
},
body: JSON.stringify({
theme: "dark",
language: "zh-CN",
notifications: {
email: true,
browser: false
}
})
});
const data = await response.json();✅ Пример успешного ответа:
{
"success": true,
"message": "Настройки успешно обновлены"
}❗ Пример реакции на ошибку:
{
"success": false,
"message": "Ошибка формата установки"
}🧾 Описание поля:
- Тело запроса может содержать любые поля пользовательских настроек и отправляется в формате JSON.