トークン取得・無効化

アクセストークン取得

アクセストークンを発行するAPIです。

エンドポイント

POST https://apis.jins.com/meme/v1/oauth/token

リクエストヘッダ

名称	型	説明
Accept	String	利用可能なアプリケーション・メディアタイプ。許可された値: “application/json”
Content-Type	String	リソース・コンテンツのアプリケーション・メディアタイプ。許可された値: “application/x-www-form-urlencoded”

リクエストボディ

名称	型	説明
grant_type	String	“authorization_code” または “refresh_token” 認可コードからアクセストークンを取得する場合は”authorization_code”を指定してください。有効期限切れのアクセストークンをリフレッシュする場合は”refresh_token”を指定してください。
code `オプション`	String	認可コード。JINSログイン後にコールバックURLに設定された認可コードを指定します。 grant_typeが”authorization_code”の場合、必須です。
redirect_uri	String	コールバックURL。JINS MEME DEVELOPERSでプラットフォーム「Web」のアプリを登録した際に設定したOAuthリダイレクトURL。
client_id	String	アプリID。JINS MEME DEVELOPERSでプラットフォーム「Web」を設定したアプリを登録した際に払い出されたアプリID。
client_secret	String	アプリSecret。JINS MEME DEVELOPERSでプラットフォーム「Web」を設定したアプリを登録した際に払い出されたアプリSecret。
refresh_token `オプション`	String	リフレッシュトークン。アクセストークン払い出しの際に返却されたリフレッシュトークンを指定します。 grant_typeが”refresh_token”の場合、必須です。

リクエストの例

curl -X POST https://apis.jins.com/meme/v1/oauth/token \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=authorization_code' \
-d 'code=67890fgehi' \
-d 'redirect_uri=https://example.com/cb' \
-d 'client_id=123456789012345' \
-d 'client_secret=67890123456789'

レスポンスボディ

名称	型	説明
access_token	String	アクセストークン。有効期間は30日です。
refresh_token	String	新しいアクセストークンを取得するためのトークン。有効期限はありません。
token_type	String	Bearer
expires_in	Number	アクセストークンの有効期限が切れるまでの秒数。
scope	String	ユーザーが付与する権限。

レスポンスの例

{
  "access_token": "47912eb18a59c28550008c725ccba1074934e00c45645a882cfe47611669c298",
  "refresh_token": "47912eb18a59c28550008c725ccba1074934e00c45645a882cfe47611669c298",
  "token_type": "bearer",
  "expires_in": 3600,
  "scope": "official"
}

アクセストークン無効化

アクセストークンを取り消します。取り消したアクセストークンは利用できなくなります。

エンドポイント

POST https://apis.jins.com/meme/v1/oauth/revoke

リクエストヘッダ

名称	型	説明
Accept	String	利用可能なアプリケーション・メディアタイプ。許可された値: “application/json”
Content-Type	String	リソース・コンテンツのアプリケーション・メディアタイプ。許可された値: “application/x-www-form-urlencoded”
Authorization	String	OAuthのBearerトークン。許可された値: “Bearer {access_token}”

リクエストボディ

名称	型	説明
token	String	アクセストークン。

リクエストの例

curl -i -X POST "https://apis.jins.com/meme/v1/oauth/revoke" \
-H "Accept:application/json" \
-H "Content-Type:application/x-www-form-urlencoded" \
-H "Authorization:Bearer xsacz2je7nyea0jya5tut02jmk3x4du55om9qskyfpajhnpcpts3gs5mng7bc8d9" \
-d "token=xsacz2je7nyea0jya5tut02jmk3x4du55om9qskyfpajhnpcpts3gs5mng7bc8d9"

レスポンスボディ

|名称|型|説明| |:–|:–|:–| |-|-|-|

レスポンスの例

{}