大家好,
一年前,我们发布了CRM API 2.0版本,它提供了比API 1.0版本更多的功能。除此之外,我们还宣布了弃用API v1.0,并且API v1.0将于2019年12月31日彻底失效。这是之前发布的公告的链接。
我们想提醒您尽快迁移到最新版本的CRM API,因为旧版本自明年开始将不可用。如果您的代码仍然使用API的1.0版本,那么它们将从2020年1月1日起停止工作,并且可能会有一些数据丢失。
在Zoho CRM内,访问 设置 > 开发者空间 > API。如果API仪表板显示有‘您的应用程序使用API v1.0’的横幅,则可能从以下一个或所有位置进行了API调用。
- Deluge函数
- 直接API调用
- 第三方集成
1. Deluge函数
Deluge函数 (在Zoho CRM或其它 Zoho服务内) 使用API v1.0调用方法 和/或 集成任务。
a. 调用方法
b. 集成任务
在Zoho CRM内,访问 设置 > 开发者空间 > 函数 并将标记为"弃用" 的函数内使用的所有v1.0集成任务更改为v2.0。
同时,请确保更改其它Zoho服务内所使用的v1.0集成任务。
参阅我们的 函数迁移向导 以就如何迁移集成任务和调用URL了解更多信息。
为了进一步停用弃用的版本,从2019年11月1日起,我们将不允许使用v1集成任务和本地v1 URL调用在Deluge中创建新函数。
此外,您将无法更新在此日期之后创建的函数,来使用v1集成任务或调用URL。
2. 直接API调用
如果您的机构有用不同编程语言编写的特定于应用程序的脚本,并且它们使用API v1.0调用Zoho CRM,那么您必须将此类实例也更改为v2.0。
使用下面的清单可以方便地迁移API。
- 检查您是否需要 迁移用户访问令牌 或使用新权限重新验证。
- 熟悉新的v2语法。API v2.0只接受JSON输入。
- 熟悉字段属性和字段格式的更改。帮助文档中也提到了这一点 : 区别 - v1 和 v2。
- 看一下v1中可用的API方法,以及它们在v2中的不同之处 这里。
- 更新应用程序中处理的错误,以将正确的状态码运用到v2错误。
3. 第三方集成
您的CRM帐户可能与任何仍然使用API v1.0的第三方应用程序(如MailChimp、Zendesk等)集成。在这种情况下,您只能敦促第三方供应商尽早迁移到2.0版本。为了加快迁移速度,我们已经向一些供应商发送了邮件,要求他们迁移到v2.0。
更新:
API v2内域"crm.zoho.com"的使用量
参阅 多数据中心支持 以获取有关各个数据中心和对应API URL的更多详细信息。
为了让每个人都知道这些变更,我们还给代码中仍使用API v1.0的所有机构的主用户发送了提醒邮件。