Знать, что совместимый хост существует, это одно. Точно знать, как перенести на него существующую интеграцию, ничего не сломав по пути, это совсем другое. Чтобы закрыть этот пробел, мы подготовили отдельный набор руководств по миграции, собранных в разделе /docs/compatibility/.
Руководства шаг за шагом описывают практическую сторону перехода: что меняется в запросе, что остаётся прежним, какой способ аутентификации использовать и на что обратить внимание в ответе, для каждого провайдера и каждого эндпоинта. Поскольку каждый из наших семнадцати совместимых хостов в точности воспроизводит форму запросов и ответов исходного провайдера, за исключением текстов об авторских правах, условиях и конфиденциальности, руководства в основном посвящены тому, что действительно отличается: имени хоста, на который нужно направить запросы, ключу, который нужно создать, и заголовкам квоты, которые теперь приходят с каждым ответом.
Мы писали их для конкретного читателя: того, у кого уже есть рабочий код для другого провайдера и кто хочет уверенности, а не просто обещания, что после переключения на нас всё продолжит работать. Это значит, что и о ценах в переходный период нужно говорить прямо. Каждый эндпоинт и каждый совместимый хост стоит одинаково, с 2 500 бесплатных запросов в день с любого адреса и ещё 2 500 бесплатных запросов в день на каждый ключ, поэтому тестирование миграции ничего не стоит, пока вы не примете решение.
Каждое руководство также охватывает мелкие детали, из-за которых миграция часто спотыкается, если их не учесть: как считаются пакетные запросы (массовый вызов засчитывает каждый элемент отдельно, а не весь вызов целиком) и что означают дополнительные заголовки квоты в каждом ответе, если вы раньше с ними не сталкивались. Когда нужное руководство открыто рядом с вашим кодом, ничего из этого не требует догадок.
Для команды, которая взвешивает переход, рекомендуемый путь прост: прочитайте руководство для провайдера, которым вы пользуетесь сейчас, создайте ключ и протестируйте несколько реальных запросов к совместимому хосту, прежде чем трогать код в продакшене. Поскольку бесплатная квота полностью покрывает такое тестирование, сравнение двух вариантов бок о бок перед решением ничего не стоит.
Полный список совместимых хостов, охваченных этими руководствами, находится по адресу /compatibility/, а общая документация по аутентификации и лимитам запросов, применимая ко всем ним, находится в разделах /docs/authentication/ и /docs/rate-limits/. Мы планируем и дальше расширять эту подборку руководств по мере роста охвата совместимости.