ステップ3: Access TokenとRefresh Tokenの生成
リクエストの実行
Grant Tokenを取得した後、access_tokenを生成するために、以下のURLに指定のパラメーターを付けてPOSTリクエストを送信してください:
https://accounts.zoho.com/oauth/v2/token?
注意: 他のデータセンターについては、それぞれのドメインにアクセスする必要があります:
- EU: https://accounts.zoho.eu/
- AU: https://accounts.zoho.au/
- IN: https://accounts.zoho.in/
- CA: https://accounts.zohocloud.ca/
- JP: https://accounts.zohocloud.jp/
- SA: https://accounts.zohocloud.sa/
| パラメーター | 説明 |
|---|---|
| code* | 前のステップで取得したGrant Tokenまたはcodeの値。 |
| client_id* | クライアント登録時に生成されたClient ID |
| client_secret* | クライアント登録時に生成されたClient Secret |
| grant_type* | authorization_code（この文字列リテラルを値として指定してください） |
| redirect_uri | 前のステップでクライアントを登録する際に指定した認可済みリダイレクトURIの1つ。未登録のredirect URIは指定できません。 |
| scope |
access_tokenを生成するスコープ。カンマで区切ることで複数のスコープを指定できます。 Catalystで利用可能なスコープの一覧は[こちらのセクション](/ja/api/oauth2/scopes/)で確認できます。 |
| state | プロトコル内でラウンドトリップされる不透明な文字列。ここで指定した値がそのまま返されます。 |
注意:
- *が付いたフィールドは必須です。
- セキュリティ強化のため、リクエストのボディにform-dataとしてパラメーターを渡すことができます。
- access_tokenは、expires_inパラメーターで指定された時間（秒単位）の経過後に失効します。
- ただし、refresh_tokenは永続的であり、現在のaccess tokenが失効した場合に新しいaccess_tokenを再生成するために使用できます。
- api_domainで指定されたドメインをリクエストに使用して、CatalystへのAPI呼び出しを行うことができます。
- token_typeの「Bearer」値は、これがaccess_tokenであることを示しています。
これで認証プロセスは完了です。アプリケーションのaccess_tokenを取得したら、HTTPリクエストの認可ヘッダーに使用してCatalyst APIにアクセスできます。例についてはリクエスト形式セクションを参照してください。
注意: 再同意ページが承認されるたびに、新しいrefresh_tokenが生成されます。ユーザーあたり最大20個のrefresh tokenを生成でき、1分間に5個のrefresh tokenを生成できます。この制限を超えると、最新のトークンに対応するため、最初のrefresh_tokenが自動的に削除されます。これは最初のトークンが使用中かどうかに関係なく行われます。
レスポンス例
copy
{
"access_token": "{access_token}",
"refresh_token": "{refresh_token}",
"api_domain": "https://www.zohoapis.com",
"token_type": "Bearer",
"expires_in": 3600
}
Yes
No
Thank you for your feedback!
Send your feedback to us
Skip
Submit