サーバー側からZoom会議を作成する-3:リフレッシュトークンとアクセストークンの取得

概要

• 前回の記事の続きです
• 認証コード、Clint ID、Client Secret、リダイレクトURLを指定して、リフレッシュトークン、アクセストークンなどを取得します
• 結果はJSONで返ってくるので、WEBブラウザ以外にプログラムでも受け取ることができます
  • 利用者が画面で関与する必要がありません

2つのトークン

• アクセストークン
  • 会議の作成などに使う
  • 約3600秒(=1時間)で有効期限が切れる
• リフレッシュトークン
  • アクセストークンを新たに生成するのに使う
  • 長さは不明だが、有効期限がある
  • アクセストークン生成時に、リフレッシュトークンも変わるので、忘れずに保存する

トークンの取得方法

• 以下の形式で送信すると、レスポンスのJSONに含まれている

curl -X POST https://zoom.us/oauth/token \
  -H "Authorization: Basic BASE64_ENCODED_CLIENT_ID_AND_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code&code=AUTHORIZATION_CODE&redirect_uri=YOUR_REDIRECT_URI"

BASIC認証

• Client IDとClient Secretを「：」で連結して、BASE64エンコードする
  • 例：Client IDが「123」、Client Secretが「abc」の場合
    • コマンドラインでは、echo "123:abc" | base64
    • JavaScriptではこんな感じ

function encodeBase64(clientID, clientSecret) {
  const credentials = clientID + ':' + clientSecret;
  const encodedCredentials = Buffer.from(credentials).toString('base64');
  return encodedCredentials;
}

認証コード (Authorization code)

• 前回の記事 で取得したもの
• 数分で期限が切れるようなので注意

リダイレクトURI

• 前回の記事 で、認証コードを受けとるために指定したリダイレクトURIを使う
• アプリ作成時にZoom App Marketplaceで指定したものと同じにする必要がある

戻り値の例

{
	"access_token": "eyJzd（中略）LRa0g",
	"token_type": "bearer",
	"refresh_token": "eyJzd（中略）Ps0HQ",
	"expires_in": 3599,
	"scope": "meeting:write:meeting:admin meeting:write:meeting:master meeting:write:invite_links:master",
	"api_url": "https://api.zoom.us"
}

トークンの保存

• アクセストークン、アクセストークンの有効期限(現在から1時間後)、リフレッシュトークンは、後で使うので保存しておきます

よくあるエラーと確認事項

{
  "reason":"unsupported grant type",
  "error":"unsupported_grant_type"
}

• 認証コードの期限が切れていないか？

次回

• 次回は、アクセストークンを使って会議を作成します