# ユーザーをログアウトする

Social APIを通じてアクセストークンを無効化することにより、アプリでのログアウトを実現できます。より良いユーザー体験のために、ユーザーがアプリからログアウトする手段を提供することをお勧めします。

# 始める前に

Social APIを呼び出すには、LINEログインの認証と認可のプロセスを通じてアクセストークンを取得する必要があります。LINEログインの使用方法について詳しくは、以下のページを参照してください。

# ユーザーをログアウトする

ユーザーをログアウトするには、リフレッシュトークンをリクエストボディに指定したHTTP POSTリクエストをエンドポイントhttps://api.line.me/oauth2/v2.1/revokeに対して実行します。このリクエストはユーザーのアクセストークンを無効化し、ユーザーをログアウトします。ユーザーのアクセストークンが無効になったときに、アプリ内のすべてのユーザーデータを削除する必要があります。

POST https://api.line.me/oauth2/v2.1/revoke

# リクエストヘッダー

ヘッダー 説明
Content-Type application/x-www-form-urlencoded

# リクエストボディ

プロパティ タイプ 必須 説明
access_token String 必須 アクセストークン
client_id String 必須 チャネルID。LINE Developersコンソールで確認できます。
client_secret String 必須 チャネルシークレット。LINE Developersコンソールで確認できます。

リクエストの例

curl -v -X POST 'https://api.line.me/oauth2/v2.1/revoke' \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id={channel id}&client_secret={channel secret}&access_token={access token}"

# レスポンス

呼び出しが成功した場合、HTTPステータスコード200 OKと空のJSONオブジェクトが返されます。

# ステータスコード

HTTPリクエストが送信されると、以下のHTTPステータスコードが返されます。

HTTPステータス 説明
200 OK リクエストが成功しました。
400 Bad Request リクエストに問題があります。リクエストパラメータとJSONの形式を確認してください。
401 Unauthorized Authorizationヘッダーを正しく送信していることを確認してください。
403 Forbidden APIの利用権限がありません。ご契約中のプランやアカウントに付与されている権限を確認してください。
429 Too Many Requests リクエスト頻度をレート制限内に抑えてください。
500 Internal Server Error APIサーバーの一時的なエラーです。

# 関連ページ

Social APIのその他の機能について詳しくは、以下のページを参照してください。