アクセストークン取得

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

エンドポイント

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

リクエストヘッダ

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

リクエストボディ

名称説明
grant_typeString“authorization_code” または “refresh_token”
認可コードからアクセストークンを取得する場合は”authorization_code”を指定してください。
有効期限切れのアクセストークンをリフレッシュする場合は”refresh_token”を指定してください。
code オプションString認可コード。JINSログイン後にコールバックURLに設定された認可コードを指定します。
grant_typeが”authorization_code”の場合、必須です。
redirect_uriStringコールバックURL。JINS MEME DEVELOPERSでプラットフォーム「Web」のアプリを登録した際に設定したOAuthリダイレクトURL。
client_idStringアプリID。JINS MEME DEVELOPERSでプラットフォーム「Web」を設定したアプリを登録した際に払い出されたアプリID。
client_secretStringアプリ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_tokenStringアクセストークン。有効期間は30日です。
refresh_tokenString新しいアクセストークンを取得するためのトークン。有効期限はありません。
token_typeStringBearer
expires_inNumberアクセストークンの有効期限が切れるまでの秒数。
scopeStringユーザーが付与する権限。

レスポンスの例

{
  "access_token": "47912eb18a59c28550008c725ccba1074934e00c45645a882cfe47611669c298",
  "refresh_token": "47912eb18a59c28550008c725ccba1074934e00c45645a882cfe47611669c298",
  "token_type": "bearer",
  "expires_in": 2592000,
  "scope": "office drive run"
}