Что на самом деле требуется для данных о местоположении «в реальном времени»
«В реальном времени» используют как синоним слова «быстро». А должно это означать, что ответ отражает текущее состояние мира, а не снимок прошлого квартала.
Тег
#проектирование-api
Как мы обрабатываем пустые результаты и результаты с низкой достоверностью
Когда запрос действительно невозможно надёжно разрешить, не вернуть ничего лучше, чем вернуть догадку, выданную за факт. Вот чем обоснован этот выбор.
Почему к данным о высоте относятся как к чему-то второстепенному
Данные о высоте редко получают отдельную строку на странице цен, и это отсутствие кое-что говорит о том, насколько серьёзно их на самом деле делают.
Против доплаты за базовые способы аутентификации
Заголовок, bearer-токен и параметр запроса аутентифицируют запрос одинаково. Брать больше за один из них значит брать деньги за предпочтение, а не за функцию.
Какие различия в лимитах запросов ждать при смене провайдера
Лимиты запросов у разных провайдеров различаются по устройству, а не только по цифрам. Вот что стоит проверить, прежде чем считать, что ваша текущая логика по-прежнему работает.
Почему мы скорее ответим ошибкой, чем неверной догадкой
Неверный ответ, который выглядит уверенно, хуже честной неудачи. Ошибка подсказывает, что нужно что-то проверить. Уверенная неверная догадка говорит, что всё в порядке.
Миграция серверной интеграции без изменений на клиенте
Миграция серверного геокодирования часто может остаться незаметной для клиентских приложений, которые от него зависят. Вот как спроектировать её именно так.
Почему ценовые уровни по странам плохая идея
Брать больше за поиск адреса в одной стране, чем в другой, значит превращать саму географию в рычаг ценообразования, вместо того чтобы отдавать обычные данные.
За полноценное отношение к определению почтовых индексов
Эндпоинт почтовых индексов, который оценён и задокументирован как нечто второстепенное, и сделан будет так же. Серьёзное отношение начинается с равного отношения.
В чём отрасль до сих пор ошибается с внедрением IPv6
API определения IP, который до сих пор считает IPv6 мелким пограничным случаем, незаметно относится к растущей доле реального интернет-трафика как к чему-то второстепенному.
Почему должны существовать квоты и на уровне аккаунта, и на уровне сети
Квота на уровне аккаунта отслеживает, кто вы. Квота на уровне сети отслеживает, откуда на самом деле идёт ваш трафик. Серьёзной системе нужны обе.
Более понятный формат ошибок во всех эндпоинтах
Все эндпоинты теперь возвращают ошибки в едином, согласованном формате, поэтому сбои проще обнаруживать, записывать в лог и обрабатывать программно.
Почему API только с вебхуками незаметно исключают пакетных пользователей
Вебхук хорошо работает для одного запроса за раз. Он плохо работает для скрипта, которому нужно просто отправить тысячу запросов и дождаться тысячи ответов.
Почему мы публикуем коды ошибок, а не скрываем их
Недокументированный код ошибки превращает каждый неудачный запрос в игру в угадайку. Опубликовать список мелочь, которая экономит реальное время на отладку.
Почему цена пакетных запросов должна совпадать с ценой одиночных
Тысяча запросов, отправленных по одному, и тысяча запросов, отправленных пакетом, это одинаковый объём работы. Цена не должна зависеть от того, как они упакованы.
За скучное и стабильное версионирование API
Захватывающая новая версия API означает проект миграции для всех, кто от неё зависит. Скучное и стабильное версионирование это достоинство, а не недостаток амбиций.
Почему мы не стали начинать с браузерного SDK
Браузерный SDK для серверного запроса по большей части лишь переносит ваш API-ключ туда, где его видит браузер посетителя. Такое удобство того не стоит.
Что решает ограничение запросов на уровне сети, чего не решают лимиты по ключу
Лимит только по ключу предполагает, что один ключ означает одного пользователя. Ограничение запросов по сети закрывает лазейку там, где это допущение незаметно перестаёт работать.
Почтовые индексы заслуживают большего уважения, чем получают
К определению почтовых индексов относятся как к мелкой утилите рядом с геокодированием, но у почтовых индексов есть реальная структура и реальные региональные различия, которые заслуживают такого же внимания.
Почему качество документации важнее количества функций
Функция, которой непонятно как пользоваться, всё равно что не существует. Документация это не расходы на поддержку, а часть самого продукта.
Скрытая цена привязки к поставщику
Привязка к поставщику редко возникает из одного плохого решения. Она складывается из сотни мелких, которые незаметно делают уход гораздо дороже, чем просто остаться.
Лимиты запросов должны быть задокументированы, а не обнаружены
Узнать свой лимит запросов через ошибку 429 в продакшене это не документация. Это обращение в поддержку, которого никогда не должно было понадобиться.
Почему мы считаем пакетные запросы по элементам, а не по вызовам
Пакетный вызов с тысячей адресов всё равно выполняет тысячу отдельных поисков. Если считать его одним запросом, это лишь скроет, куда на самом деле ушло использование.
Против проприетарных форматов ответа
Проприетарное имя поля или собственная объектная модель ничего не экономят провайдеру, а клиенту позже обходятся переписыванием кода. Простой и предсказуемый JSON это не недостающая функция.
В чём оплата за каждый продукт ошибается насчёт того, как используются API
Реальные приложения сочетают геокодирование, определение IP и запросы часовых поясов в одном пути обработки запроса. Тарификация их как отдельных продуктов игнорирует то, как они используются вместе.
Открытые данные о часовых поясах не должны быть премиум-функцией
Определение часовых поясов работает на публичном, активно поддерживаемом источнике данных. Отдельная премиальная плата за такой запрос не отражает реальных дополнительных затрат.
Почему совместимые хосты важнее нового SDK
SDK просит вас доверять клиентской библиотеке одной компании на протяжении всей жизни проекта. Совместимый хост просит изменить одну строку конфигурации.
Почему мы установили цену за запрос, а не за пользователя
Цена за запрос соответствует реальной стоимости работы API. Цена за пользователя измеряет численность сотрудников, а не использование, и трафик геокодирования редко зависит от того или другого.