メインコンテンツまでスキップ

認証と認可

1. ユーザーのログインおよび登録プロセス​

  • ログイン:
    ユーザーは、メールアドレスとパスワードを提供します。ログインが成功すると、サーバーはアクセス・トークン（JWT または OAuth）を返し、その後の API リクエストで使用されます。

  • 検証:
    システムは、データベース内の認証情報と照合し、正しい場合は成功メッセージとトークンを返し、誤っている場合はエラーメッセージを返します。

2. トークン付与および認証（OAuth、JWT など）​

認証は、JWT（JSON Web Tokens）または OAuth トークンに基づいています：

  • JWT:
    ログインが成功すると、システムは認証の証明として JWT を返します。このトークンは、後続の API 呼び出しに使用され、Authorization ヘッダーに Bearer {token} として含める必要があります。

  • OAuth:
    OAuth 認証が使用される場合、システムは Google や Facebook などのサードパーティ OAuth プロバイダーをサポートします。ユーザーはプロバイダーの認証情報を使用して認証を行い、その後、API 呼び出しを認証するための OAuth トークンが生成されます。

3. ログアウトおよびセッション関連の問題の取り扱い​

  • ログアウト:
    ログアウトするには、ユーザーはログアウトエンドポイントに POST リクエストを送信し、現在のセッションを無効にしてアクセス・トークンを取り消します。

  • セッション関連の問題:
    トークンの有効期限切れや無効なセッション状態などのセッション関連の問題は、401 Unauthorized のレスポンスとして返されます。