EggyByte Server
  1. AuthService
EggyByte Server
  • Default module
    • 项目介绍
    • 用户协议
    • 隐私政策
    • SuperDungeon
      • 超能魔盗团 隐私政策
      • User
        • Get User Data
        • Free Lottery
        • Paid Lottery
        • Sell Artwork
        • Find Top Users
        • Get Initial Data
        • Get Access
        • Change Name
      • Rank
        • Update
        • Find Top Users
      • Local
      • Remote
    • EggyByte
      • Account
        • Login
        • Register
        • Login Or Register
        • Access
        • Buy
        • Get Public Access
        • Formal Register
      • Game
        • Save Data
        • Load Data
      • Test
        • Random String
        • Get Map Json
      • Crypto
        • Compute Hash
        • Encrypt
        • Encrypt Map
        • Decrypt
      • Ad
        • Show
        • Debug
        • Impression Callback
      • User
        • Lock Test
        • Get User Data
        • Open Chest
      • Admin
        • Create Api Roles Copy
        • Create Api Roles Copy Copy
        • Delete Api Roles
        • Create Api Roles
      • Database
        • Update Mongo Users
        • List Databases
        • List Collections
        • List Mongo Users
        • Get Collection Stats
        • Get Collection Info
        • Get Paginated Documents
        • Create Mongo Users
        • Create Mongo Databases
      • Mailing
        • Send Mail
        • Send Captcha
        • Check Captcha
      • ThirdParty
        • Connect Url
        • Callback
        • Payment Link
    • 1
    • Untitled Endpoint
      GET
    • Untitled Endpoint
      POST
    • Setup
      POST
    • Create Database
      POST
    • Get Card
      GET
    • Create Question
      POST
    • Create Collection
      POST
    • Get Dashboards
      GET
    • Get Dashboard
      GET
    • Get Dashboard Copy
      POST
    • Untitled Endpoint
      GET
    • Untitled Endpoint
      GET
    • Schemas
      • 示例数据模型
        • Random Map
  • tester/v1/tester.proto
    • TesterService
      • List recent test runs with optional filtering.
      • Run a multi-service test suite in one request.
      • Run focused tests for a single service.
      • Retrieve a previously executed test run by ID.
    • Schemas
      • Schemas
        • protobufAny
        • rpcStatus
        • v1CrossServiceTestResult
        • v1GetTestRunResponse
        • v1ListTestRunsResponse
        • Standard pagination request
        • Standard pagination response
        • v1RunServiceTestsRequest
        • v1RunServiceTestsResponse
        • v1RunTestSuiteRequest
        • v1RunTestSuiteResponse
        • v1ServiceTestResult
        • v1TargetService
        • v1TestCaseResult
        • v1TestExecutionOptions
        • v1TestRun
        • v1TestRunStatus
        • v1TestRunSummary
  • auth/v1/auth.proto
    • AuthService
      • GetJWKS returns the JSON Web Key Set for token validation Used by Higress and other services to validate JWT tokens
        GET
      • GetOIDCDiscovery returns the OIDC discovery document Required for Higress OIDC plugin configuration
        GET
      • Authorize initiates the OAuth2/OIDC authorization flow Standard OIDC authorization endpoint for Higress integration
        GET
      • Authorize initiates the OAuth2/OIDC authorization flow Standard OIDC authorization endpoint for Higress integration
        POST
      • IntrospectToken validates and returns information about a token RFC 7662 - OAuth 2.0 Token Introspection (internal use only)
        POST
      • RevokeToken revokes an access or refresh token RFC 7009 - OAuth 2.0 Token Revocation
        POST
      • Token exchanges authorization code or refresh token for access tokens Standard OIDC token endpoint for Higress integration
        POST
      • GetUserInfo returns user information from a valid access token Standard OIDC UserInfo endpoint for Higress integration
        GET
      • GetUserInfo returns user information from a valid access token Standard OIDC UserInfo endpoint for Higress integration
        POST
      • ListUsers lists all users with auth information (admin only)
        GET
      • UpdateUserRole updates user's role (admin only)
        PUT
      • SendEmailVerification sends email verification code
        POST
      • VerifyEmail verifies email with verification code
        POST
      • ResolveUserIdentity resolves JWT token and returns user identity context Called by Higress OIDC plugin to get user information for header injection
        POST
      • Login authenticates user credentials and returns tokens
        POST
      • Logout invalidates user tokens and sessions
        POST
      • ChangePassword changes user password (requires authentication)
        POST
      • ConfirmPasswordReset confirms password reset with code
        POST
      • ResetPassword initiates password reset flow
        POST
      • RefreshToken refreshes an access token using a refresh token
        POST
      • Register creates a new user account with authentication credentials
        POST
      • GetUserSessions retrieves active sessions for a user
        GET
      • RevokeUserSession revokes a specific user session
        DELETE
    • Schemas
      • Schemas
        • AuthServiceUpdateUserRoleBody
        • protobufAny
        • rpcStatus
        • v1AuthorizeError
        • v1AuthorizeRedirect
        • v1AuthorizeRequest
        • v1AuthorizeResponse
        • v1AuthorizeSuccess
        • v1ChangePasswordRequest
        • v1ChangePasswordResponse
        • v1ConfirmPasswordResetRequest
        • v1ConfirmPasswordResetResponse
        • v1GetJWKSResponse
        • v1GetOIDCDiscoveryResponse
        • v1GetUserInfoResponse
        • v1GetUserSessionsResponse
        • v1IntrospectTokenRequest
        • v1IntrospectTokenResponse
        • v1JWK
        • v1ListUsersResponse
        • v1LoginRequest
        • v1LoginResponse
        • v1LogoutRequest
        • v1LogoutResponse
        • v1RefreshTokenRequest
        • v1RefreshTokenResponse
        • v1RegisterRequest
        • v1RegisterResponse
        • v1ResetPasswordRequest
        • v1ResetPasswordResponse
        • Request to resolve user identity from JWT token (called by Higress OIDC plugin)
        • Response containing user identity context for injection into business microservices
        • v1RevokeTokenRequest
        • v1RevokeTokenResponse
        • v1RevokeUserSessionResponse
        • v1SendEmailVerificationRequest
        • v1SendEmailVerificationResponse
        • Token metadata for audit and debugging
        • v1TokenRequest
        • v1TokenResponse
        • v1UpdateUserRoleResponse
        • User identity information (injected by Higress gateway)
        • Core user information structure (simplified for cross-service use)
        • User roles in the EggyByte system
        • v1UserSession
        • User account status
        • v1VerifyEmailRequest
        • v1VerifyEmailResponse
  1. AuthService

Login authenticates user credentials and returns tokens

POST
/v1/login

Request

Body Params application/jsonRequired

Example
{
    "email": "string",
    "password": "string",
    "clientId": "string",
    "rememberMe": true,
    "scope": "string",
    "deviceInfo": "string",
    "userAgent": "string",
    "ipAddress": "string"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/login' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "string",
    "password": "string",
    "clientId": "string",
    "rememberMe": true,
    "scope": "string",
    "deviceInfo": "string",
    "userAgent": "string",
    "ipAddress": "string"
}'

Responses

🟢200OK
application/json
A successful response.
Body

Example
{
    "user": {
        "userId": "string",
        "email": "string",
        "displayName": "string",
        "role": "USER_ROLE_UNSPECIFIED",
        "permissions": [
            "string"
        ],
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "status": "USER_STATUS_UNSPECIFIED",
        "emailVerified": true,
        "avatarUrl": "string",
        "timezone": "string",
        "language": "string"
    },
    "accessToken": "string",
    "refreshToken": "string",
    "expiresIn": 0,
    "idToken": "string",
    "scope": "string",
    "sessionId": "string",
    "requiresMfa": true
}
🟢200Success
Modified at 2025-09-27 16:13:30
Previous
ResolveUserIdentity resolves JWT token and returns user identity context Called by Higress OIDC plugin to get user information for header injection
Next
Logout invalidates user tokens and sessions
Built with