新闻

迁移指南:切换服务商的新去处

知道有兼容主机是一回事,确切知道如何把现有集成迁移上去且一路上不出任何问题,是另一回事。为了弥补这一差距,我们编写了一套专门的迁移指南,集中放在 /docs/compatibility/

这些指南逐一介绍切换的实际步骤:请求中哪些会变,哪些保持不变,使用哪种身份验证方式,以及响应中需要注意什么,按服务商、按端点逐一说明。由于我们的十七个兼容主机都完全复现了原服务商的请求和响应格式(版权、条款和隐私文字除外),指南主要关注真正不同的部分:要指向的主机名、要生成的密钥,以及现在随每个响应一起返回的配额响应头。

我们在编写时心中有一位特定的读者:已经有针对其他服务商的可用代码,并希望得到确信(而不仅仅是承诺),把代码指向我们后仍能正常工作。这意味着在过渡期间也要把价格说清楚。所有端点和所有兼容主机价格相同,任何地址每天都有 2,500 次免费请求,每个密钥每天另有 2,500 次免费请求,因此在您正式决定之前,测试迁移不花任何费用。

每份指南还涵盖了那些如果不加处理就容易让迁移出错的小细节:批量请求如何计数(批量调用按每一项单独计数,而不是按整个调用计数),以及如果您以前没见过,每个响应上额外的配额响应头分别是什么意思。只要把相关指南打开放在代码旁边,这些都无需猜测。

对于正在考虑是否迁移的团队,推荐的路径很直接:阅读您当前所用服务商的指南,生成一个密钥,在改动任何生产代码之前,先对兼容主机测试几个真实请求。由于免费配额完全覆盖这些测试,在做决定之前把两者并排比较不会产生任何费用。

这些指南所涵盖的兼容主机完整列表位于 /compatibility/,适用于所有兼容主机的通用身份验证和速率限制文档位于 /docs/authentication//docs/rate-limits/。随着兼容覆盖范围的扩大,我们计划继续扩充这套指南。