大家好,
一年前，我们发布了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的更多详细信息。
为了让每个人都知道这些变化，我们已经
- 给仍在代码中使用v1.0 API的所有机构的主用户发送提醒邮件。
- 在设置面板上显示一个横幅，提醒使用v1.0 API的用户。
- 在“函数”页上显示一个横幅，附带一个PDF，其中包含机构中需要迁移到v2.0的函数列表。
更新：
横幅什么时候展示？
- 您在过去24小时内进行了v1.0 API调用。
- 在“函数”页上，当函数仍然使用v1.0集成任务或调用URL时。请注意，这些统计数据每24小时刷新一次。因此，即使您更新/删除了一个使用v1.0代码的函数，在刷新统计数据之前，它仍然会出现在PDF中。