初始化
定义 OAuth 配置文件后,此应用将准备初始化。
生成自授权的授权和刷新令牌
对于独立客户端应用,应通过 Zoho 开发者控制台 (https://accounts.zoho.com/developerconsole) 生成自授权的授权令牌。
- 请访问 https://accounts.zoho.com/developerconsole
- 点击要对其授权的客户端的选项 → 独立客户端。
- 在“范围”字段中输入您要授权的一个或多个(各项之间用逗号分隔)有效 Zoho CRM 范围,然后选择到期日期。输入“aaaserver.profile.READ”范围及 Zoho CRM 范围。
- 复制授权令牌以进行备份。
- 借助创建带有以下 URL 的 POST 请求,通过授权令牌生成刷新令牌 https://accounts.zoho.com/oauth/v2/token?code={grant_token}&redirect_uri={redirect_uri}&client_id={client_id}&client_secret={client_secret}&grant_type=authorization_code
- 复制刷新令牌以进行备份。
请注意,所生成授权令牌仅在您生成它时选择的约定期限内有效。因此,应在该时间范围内生成访问令牌和刷新令牌。
生成访问令牌
可通过授权令牌或刷新令牌生成访问令牌。遵循下列任一方法就足够了。
通过授权令牌生成访问令牌
应通过您的主类执行以下代码片段以获取访问令牌和刷新令牌。请将所复制的授权令牌粘贴到下面指示的字符串中。这是一次性过程。
ZCRMRestClient::initialize();
$oAuthClient = ZohoOAuth::getClientInstance();
$grantToken = “paste_the_self_authorized_grant_token_here”;
$oAuthTokens = $oAuthClient->generateAccessToken($grantToken);
$oAuthClient = ZohoOAuth::getClientInstance();
$grantToken = “paste_the_self_authorized_grant_token_here”;
$oAuthTokens = $oAuthClient->generateAccessToken($grantToken);
请注意,对于每个授权令牌,以上代码片段仅生效一次。成功执行以上代码片段后,所生成访问令牌和刷新令牌将通过保存 handler 类保存下来。
通过刷新令牌生成访问令牌
应通过您的主类执行以下代码片段以获取访问令牌和刷新令牌。请将所生成的刷新令牌粘贴到下面指示的字符串中。这是一次性过程。
ZCRMRestClient::initialize();
$oAuthClient = ZohoOAuth::getClientInstance();
$refreshToken = "paste_the_refresh_token_here";
$userIdentifier = "provide_user_identifier_like_email_here";
$oAuthTokens = $oAuthClient->generateAccessTokenFromRefreshToken($refreshToken,$userIdentifier);
$oAuthClient = ZohoOAuth::getClientInstance();
$refreshToken = "paste_the_refresh_token_here";
$userIdentifier = "provide_user_identifier_like_email_here";
$oAuthTokens = $oAuthClient->generateAccessTokenFromRefreshToken($refreshToken,$userIdentifier);
成功执行以上代码片段后,所生成访问令牌和给定的刷新令牌将通过保存 handler 类保存下来。
保存 OAuth 令牌后,后续 API 令牌将使用所保存的访问令牌和刷新令牌。必要时,PHP SDK 将负责使用刷新令牌来刷新访问令牌。
启动应用
每次启用您的客户端应用时,PHP SDK 需要调用以下代码行。
ZCRMRestClient::initialize();
以上代码行初始化 PHP SDK 后,您可使用该 SDK 的任意 API 来获取相应结果。