Перейти к основному содержимому

Что нового

История изменений API и правила версионирования.

Политика версионирования​

Версия API указана в адресе: /v1. Мы придерживаемся простого правила — существующие интеграции не должны ломаться без предупреждения.

Считается совместимым изменением (может появиться в любой момент, без смены версии):

  • добавление новых эндпоинтов;
  • добавление новых необязательных параметров запроса;
  • добавление новых полей в ответ;
  • добавление новых значений в списки (где это не меняет смысл существующих).

Поэтому ваш код должен игнорировать незнакомые поля в ответах, а не падать на них.

Считается несовместимым изменением (выходит только в новой версии, например /v2):

  • удаление или переименование эндпоинтов, параметров или полей;
  • изменение типа или смысла существующего поля;
  • ужесточение обязательности параметров.

О несовместимых изменениях и о выводе версий из эксплуатации мы предупреждаем заранее.

Изменения​

2026-07-09 — первый публичный выпуск​

  • Документы: список и получение по идентификатору.
  • Чтение значений: диапазон, batchGet, пагинация, открытые диапазоны.
  • Запись значений: PUT, batchUpdate, append, clear, формулы и спилл.
  • Идемпотентность записи через заголовок Idempotency-Key.
  • Листы: список, создание, переименование, удаление.
  • Вебхуки: подписки, доставка с HMAC-подписью, канал Telegram.
  • Аудит изменений через API.
  • Тарифные лимиты по частоте запросов, токенам и вебхукам.