История изменений API

Изменения REST + oRPC + полезных нагрузок вебхуков для AACSearch. Подпишитесь, если вы работаете с публичным API и хотите получать выжимку изменений без шума панели управления и SDK.

Эта страница — выжимка из /changelog, затрагивающая вызовы REST API AACSearch, процедур oRPC и полезных нагрузок вебхуков. Формат соответствует Формату журнала изменений.

Версионирование

Версии REST API закреплены в URL (/api/v1/...). См. Политику версионирования и прекращения поддержки с правилами появления новой мажорной версии и срокам, в течение которых предыдущая мажорная версия остаётся доступной для вызовов.

v1 — Стабильная

2026-05-05

Добавлено — Request ID (X-Request-Id) в каждом ответе. Принимает входящий UUID v4 или генерирует новый. Логи включают requestId, orgId, indexId, authType, route. (AAC-024)

2026-05-03

Добавлено — параметр JOIN include_fields в поисковых процедурах. SearchDocumentsInput.includeFields принимает JOIN-синтаксис AACSearch, например $Category(id, name). (AAC-569)
Добавлено — параметр diversify_based_on, проведённый через searchDocuments() и multiSearchDocuments() для MMR-диверсификации. (AAC-574)

Полезные нагрузки вебхуков

Полезные нагрузки вебхуков версионируются по имени события (document.upserted.v1, sync.completed.v2). Новая версия публикуется вместо изменения существующей полезной нагрузки — получатели подписываются на конкретную версию в конфигурации вебхука.

Изменения полезных нагрузок вебхуков публикуются здесь под тегом области API с именем события в записи, например:

### Добавлено

- **API · Webhook**: полезная нагрузка `document.upserted.v2` теперь
  включает `previousIndexedAt`. Получатели на `v1` не затрагиваются.
  (AAC-XXX)

Как подписаться

Для автоматического отслеживания изменений API:

RSS-лента на https://docs.aacsearch.com/changelog/api.rss (Roadmap — см. /reference/claim-status).
Релизы GitHub по тегу aacsearch/api.
Заголовок ответа X-Deprecated в течение 12-месячного окна прекращения поддержки, машиночитаемый для мониторинга.