bestsub
  1. 认证
bestsub
  • 认证
    • 用户登录
      POST
    • 用户登出
      POST
    • 刷新访问令牌
      POST
    • 修改用户名
      POST
    • 修改密码
      POST
    • 删除会话
      DELETE
    • 获取用户会话列表
      GET
    • 获取用户信息
      GET
  • 系统
    • 健康检查
      GET
    • 系统信息
      GET
    • 存活检查
      GET
    • 就绪检查
      GET
    • 系统版本
      GET
  • 日志
    • 实时日志
    • 获取日志内容
      GET
    • 获取日志列表
      GET
  • 分享
    • 获取分享链接
      GET
    • 创建分享链接
      POST
    • 获取订阅内容 纯Mihomo格式的节点
      GET
    • 获取订阅内容 带规则的订阅
      GET
    • 更新分享链接
      PUT
    • 删除分享链接
      DELETE
  • 检测
    • 获取检测列表
      GET
    • 创建检测
      POST
    • 获取检测类型
      GET
    • 更新检测
      PUT
    • 删除检测
      DELETE
    • 手动运行检测
      POST
    • 停止检测
      POST
  • 配置
    • 获取配置项
    • 更新配置项
  • 通知
    • 获取通知
    • 更新通知
    • 创建通知
    • 删除通知
    • 获取通知渠道
    • 获取渠道配置
    • 获取通知名称和ID
    • 获取通知模板
    • 更新通知模板
    • 测试通知
  • 订阅
    • 获取订阅链接
    • 更新订阅链接
    • 创建订阅链接
    • 手动刷新订阅
    • 删除订阅链接
    • 批量创建订阅链接
  • 存储
    • 获取存储
    • 创建存储
    • 获取存储渠道
    • 获取渠道配置
    • 更新存储
    • 删除存储
  • 更新
    • 最新版本
    • 更新
  • 数据模型
    • Schemas
      • github_com_bestruirui_bestsub_internal_core_check.Desc
      • github_com_bestruirui_bestsub_internal_core_update.LatestInfo
      • github_com_bestruirui_bestsub_internal_models_auth.ChangePasswordRequest
      • github_com_bestruirui_bestsub_internal_models_auth.Data
      • github_com_bestruirui_bestsub_internal_models_auth.LoginRequest
      • github_com_bestruirui_bestsub_internal_models_auth.LoginResponse
      • github_com_bestruirui_bestsub_internal_models_auth.RefreshTokenRequest
      • github_com_bestruirui_bestsub_internal_models_check.Request
      • github_com_bestruirui_bestsub_internal_models_auth.SessionResponse
      • github_com_bestruirui_bestsub_internal_models_auth.SessionListResponse
      • github_com_bestruirui_bestsub_internal_models_check.Response
      • github_com_bestruirui_bestsub_internal_models_auth.UpdateUserInfoRequest
      • github_com_bestruirui_bestsub_internal_models_check.Result
      • github_com_bestruirui_bestsub_internal_models_sub.Response
      • github_com_bestruirui_bestsub_internal_models_check.Task
      • github_com_bestruirui_bestsub_internal_models_notify.Template
      • github_com_bestruirui_bestsub_internal_models_node.Filter
      • github_com_bestruirui_bestsub_internal_models_node.SimpleInfo
      • github_com_bestruirui_bestsub_internal_models_notify.Request
      • github_com_bestruirui_bestsub_internal_models_system.HealthResponse
      • github_com_bestruirui_bestsub_internal_models_notify.NameAndID
      • github_com_bestruirui_bestsub_internal_models_notify.Response
      • github_com_bestruirui_bestsub_internal_models_share.Response
      • github_com_bestruirui_bestsub_internal_models_share.Request
      • github_com_bestruirui_bestsub_internal_models_setting.Setting
      • github_com_bestruirui_bestsub_internal_models_share.GenConfig
      • github_com_bestruirui_bestsub_internal_models_storage.Response
      • github_com_bestruirui_bestsub_internal_models_system.Info
      • github_com_bestruirui_bestsub_internal_modules_notify.Desc
      • github_com_bestruirui_bestsub_internal_models_share.SubConverterConfig
      • github_com_bestruirui_bestsub_internal_models_storage.Request
      • github_com_bestruirui_bestsub_internal_models_sub.Config
      • github_com_bestruirui_bestsub_internal_models_sub.Request
      • github_com_bestruirui_bestsub_internal_models_sub.Result
      • github_com_bestruirui_bestsub_internal_modules_storage.Desc
      • github_com_bestruirui_bestsub_internal_server_resp.ResponseStruct
      • github_com_bestruirui_bestsub_internal_models_system.Version
  1. 认证

用户登录

POST
/api/v1/auth/login
用户登录接口,验证用户名和密码,返回JWT令牌

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json

示例
{
    "password": "admin",
    "username": "admin"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://localhost:8080/api/v1/auth/login' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "password": "admin",
    "username": "admin"
}'

返回响应

🟢200成功
application/json
登录成功
Body

示例
{
    "code": 200,
    "data": {
        "access_expires_at": "2024-01-01T12:00:00Z",
        "access_token": "access_token_string",
        "refresh_expires_at": "2024-01-01T12:00:00Z",
        "refresh_token": "refresh_token_string"
    },
    "message": "success"
}
🟠400请求有误
🟠401没有权限
🔴500服务器错误
修改于 2025-09-23 06:28:45
下一页
用户登出
Built with