Skip to main content

​
エンドポイント一覧

​
POST /account/reset-password

サインイン済みユーザーのパスワードを変更します。現在のパスワード認証が必要です。 Required: Bearer Token (JWT) Request Body 
{
  "currentPassword": "current_password",
  "newPassword": "new_secure_password"
}
Response 
{
  "data": {
    "message": "Password reset successfully"
  }
}
エラーレスポンス
  • 400: 現在のパスワードが正しくない
  • 404: ユーザーが見つからない

​
POST /account/forgot-password

パスワードリセット用の6桁の認証コードをメールで送信します。 Request Body 
{
  "email": "[email protected]"
}
Response 
{
  "data": {
    "message": "Reset code sent to your email"
  }
}

​
POST /account/forgot-password/verify

メールで送信された6桁のリセットコードを使用してパスワードを変更します。 Request Body 
{
  "email": "[email protected]",
  "code": "123456",
  "newPassword": "new_secure_password"
}
Response 
{
  "data": {
    "message": "Password reset successfully"
  }
}
エラーレスポンス
  • 400: 無効なリセットコード

​
GET /account/profile

現在のユーザーのプロフィール情報を取得します。 Required: Bearer Token (JWT) Response 
{
  "data": {
    "id": "user_id",
    "email": "[email protected]",
    "username": "username",
    "createdAt": "2024-01-01T00:00:00.000Z"
  }
}

​
PUT /account/profile

現在のユーザーのプロフィール情報を更新します。 Required: Bearer Token (JWT) Request Body 
{
  "username": "new_username"
}
Response 
{
  "message": "Profile updated successfully",
  "user": {
    "id": "user_id",
    "username": "new_username"
  }
}
エラーレスポンス
  • 400: ユーザー名が既に使用されている
  • 404: ユーザーが見つからない

​
POST /account/set-password

外部プロバイダーで登録したユーザーが初めてパスワードを設定します。 既にパスワードが設定されている場合はエラーを返します。 Required: Bearer Token (JWT) Request Body 
{
  "password": "new_secure_password"
}
Response 
{
  "message": "Password set successfully"
}
エラーレスポンス
  • 400: パスワードが既に設定されている
  • 404: ユーザーが見つからない

​
POST /account/email/change

メールアドレス変更リクエストを送信します。新しいメールアドレスに認証コードが送信されます。 Required: Bearer Token (JWT) Request Body 
{
  "newEmail": "[email protected]"
}
Response 
{
  "message": "Verification code sent to new email address"
}
エラーレスポンス
  • 400: メールアドレスが既に使用されている

​
POST /account/email/change/verify

メールアドレス変更の認証コードを検証し、メールアドレスを変更します。 Required: Bearer Token (JWT) Request Body 
{
  "verificationCode": "123456"
}
Response 
{
  "message": "Email changed successfully",
  "newEmail": "[email protected]"
}
エラーレスポンス
  • 400: 無効な認証コード

​
GET /account/security/status

ユーザーのセキュリティ状態を取得します。パスワード設定可能性などを確認できます。 Required: Bearer Token (JWT) Response 
{
  "data": {
    "canSetPassword": true,
    "hasPassword": false,
    "providers": ["google", "discord"]
  }
}

​
POST /account/providers/unlink

外部認証プロバイダーとの連携を解除します。 Required: Bearer Token (JWT) Request Body 
{
  "provider": "google"
}
Response 
{
  "message": "Provider unlinked successfully"
}
エラーレスポンス
  • 400: プロバイダーが見つからない