API 版本 2.0新功能

• OAuth2.0
• REST API
• 只支持JSON
• 用于Zoho CRM v2 api和多数据中心处理的专用域
• 端点的变化
• API 名称
• 限制和节流
• 页码
• 日期/时间格式

OAuth 2.0

V2 API使用OAuth2.0协议进行身份验证。它们使用授权代码授予类型来获取访问令牌。这种授权类型允许您与任何应用程序共享特定的数据，同时保持用户名和密码的私密性。

该协议还允许您使用选定的范围来控制客户端应用程序可以访问的资源类型。 参考V2 API的OAuth 2.0-概述了解更多信息。

REST API

所有V2 API都遵循REST标准，例如，它们使用HTTP请求方法GET、POST、PUT、DELETE等。

• GET - 获取记录

• POST - 插入新的记录

• PUT - 更新已有记录

• DELETE - 删除记录

所有输入和响应都是JSON格式。

所有的响应都有一个HTTP 状态码。

只支持JSON

所有V2 API输入和响应都只有JSON格式，而V1 API同时支持XML和JSON。

使用JSON的一些优点是：

• 避免繁琐：JSON没有像XML那样的标记，因此需要更少的字符来表示数据。

• 更快：由于JSON使用较少的数据，因此易于读取和解析数据，从而提高了解析速度。

• 可读性强：JSON数据非常直观，易于阅读。

专用CRM域和多数据中心处理

Zoho CRM V2 API有一个专用域https://www.zohoapis.com/ (美国)

这对于服务CORS请求很有帮助。

其他受支持的域包括：

• 欧洲 - https://www.zohoapis.eu/

• 中国 - https://www.zohoapis.com.cn/

• 印度 - https://www.zohoapis.in/

有关更多信息，请参考多数据中心。

备注：
CRM帐户的默认域是美国

端点的变化

V2 API有端点https://www.zohoapis.com.cn/crm/v2/在这里，
https://www.zohoapis.com是域名而
/crm/v2/CRM V2 API的端点

例如，获取CRM中线索列表的请求URL是
https://www.zohoapis.com.cn/crm/v2/Leads

API 名称

Zoho CRM v2 API在创建自定义模块、字段或相关列表标签时使用内部生成的API名称。系统在JSON数据中访问CRM API时使用这个键"api_name"。这确保自定义模块或字段中的标签名称更改不会影响现有的集成。

例如，Leads代表线索模块，currency代表货币字段，Notes代表备注相关列表。V1 API使用显示标签。

限制和节流

Zoho CRM V2 API使用一个信用系统为您的应用程序提供一个利率限制。

Zoho CRM企业版的最大信用额度现在是500,000，而对于超级版本是一百万。API调用限制从调用开始有一个24小时的滚动窗口，而不是像V1 API中在凌晨00:00重置信用额度。

Zoho CRM还使用一个并发系统，根据Zoho CRM中每个用户每个应用程序的并发调用数量计算API限制。这些并发限制指定了每个应用程序的用户在给定时间可以同时激活的API调用的最大数量。

有关更多信息，请参考API限制。

页码

所有v2 API GET响应都有以下“info”JSON对象。

• "per_page" ：使用此参数可设置要获取的每页记录的数量。默认值是200。

• "page"： 使用此参数获取该页上的记录。默认值是1。

• "more_records"：此参数指示该模块中是否有更多记录。值为真或假。

日期/时间格式

V2 API遵循ISO 8601包含时区的日期时间格式，而V1 API遵循该格式yyyy-MM-dd HH:mm:ss。例如：
v2: 2018-03-28T10:32:45+05:30
v1: 2013-06-26 10:37:48