Zoho crm Logo

客户端凭证流程

与自我客户端流程中创建访问令牌的流程相比,客户端凭证流程可以用于执行一次性任务,如一次性数据迁移或测试Zoho CRM API调用等。我们建议使用自我客户端或基于服务器的授权进行集成。客户端凭证流程的主要优点是创建访问令牌的简单性,只需要您的客户端ID,客户端密钥,范围和soid。

生成访问令牌

要使用客户端凭据流生成访问令牌,请对以下端点进行API调用,并按照下面"参数"部分所述提供必要的参数。accounts-url特指客户端注册的位置(即,数据中心)。查看所有服务器特定的URL。

{accounts-url}/oauth/v2/token?client_id={client_id}&client_secret={client_secret}&grant_type=client_credentials&scope={scope}&soid={soid}

参数

  • client_id字符串,必填

    客户端ID(消费者密钥),您在客户端注册期间获得。

  • client_secret字符串,必填

    您在客户端注册期间获得的客户端密钥。

  • grant_type字符串,必填

    指定值为 "client_credentials"。

  • scope字符串,必填

    您希望从用户账户访问资源的相应范围。可以以逗号分隔的格式给出多个范围。有关更多详细信息,请参阅范围页面。

  • soid字符串,必填

    此参数源自唯一的ServiceOrg或组织或门户ID(zsoid)。

    语法:ZohoCRM.{zsoid}。示例:ZohoCRM.600xxx46

    您可以通过点击您的个人资料图片从UI获取zsoid,您将看到您的组织名称。点击下拉菜单查看组织名称和Org ID。

Response JSON

{ "access_token": "1000.b2caxxxxx3c6", "scope": "ZohoCRM.org.ALL ZohoCRM.settings.ALL ZohoCRM.users.ALL ZohoCRM.templates.email.READ ZohoCRM.templates.inventory.READ ZohoCRM.modules.ALL", "api_domain": "https://www.zohoapis.com", "token_type": "Bearer", "expires_in": 3600 }
  • access_token

    在API调用的头部使用此访问令牌来访问Zoho CRM中的数据。请注意,响应中不包含刷新令牌。当访问令牌过期时,对同一端点进行API调用以获取新的访问令牌(如果需要)。

  • 范围

    您希望从用户账户访问的资源的范围,该范围在参数中已提供。

  • api_domain

    API的域名。在您的请求中使用此域名来对Zoho CRM进行API调用。

  • token_type

    获取的令牌类型。“Bearer”表示这是一个访问令牌。

  • expires_in

    访问令牌过期后的秒数。