Skip to content

API-аудит 2026-06-19: настройки входящего вебхука бота, sort в поиске сообщений - #262

Merged
lookinway merged 1 commit into
mainfrom
api-audit-2026-06-19
Jun 19, 2026
Merged

API-аудит 2026-06-19: настройки входящего вебхука бота, sort в поиске сообщений#262
lookinway merged 1 commit into
mainfrom
api-audit-2026-06-19

Conversation

@lookinway

@lookinway lookinway commented Jun 19, 2026

Copy link
Copy Markdown
Collaborator

Аудит бэкенда с 2026-06-16

Точка отсчёта — последний файл обновлений 2026-06-16.md. Сверка только с origin/master (HEAD dd28f4ff). Публичный API = api/shared/v1.

Публичные находки (задокументированы)

BAK-2870 — настройки входящего вебхука бота на POST/PUT/GET /bots:

Поле Тип Запрос Ответ
template string опц. string | null
template_engine enum liquid/mustache опц., дефолт liquid non-null
challenge_key string опц. string | null
link_preview_enabled boolean опц., дефолт true non-null

sort в GET /search/messagescreated_at (по умолчанию) / relevance (enum MessageSearchSort). Влит в master 2026-06-18 в составе миграции поискового индекса.

Версии пакетов

  • SDK 1.0.24, CLI 2026.6.2, n8n 2.0.12, generator 1.1.7
  • releases.json + changelog'и пакетов + n8n README/DEVELOPMENT + пример pachca doctor в гайде CLI

Заодно

  • Python SDK: фикс NameError в авто-ретрае на 429/5xx (генератор: _jitter_add_jitter), снапшоты перегенерированы. Баг был только в Python.
  • Новый тест-guard в generator.test.ts (без внешних зависимостей): каждый вызов приватного хелпера _name( в сгенерированном Python обязан иметь def _name( в том же файле — ловит drift объявления/вызова даже после regen-snapshots. Проверено: с багом 12 тестов падают, с фиксом 22/22 зелёные.

… сообщений

Аудит бэкенда с 2026-06-16 (origin/master HEAD dd28f4ff).

Публичные находки (api/shared/v1):
- BAK-2870: настройки входящего вебхука бота (template, template_engine,
  challenge_key, link_preview_enabled) на POST/PUT/GET /bots — request,
  response (BotWebhook) и enum BotTemplateEngine.
- sort в GET /search/messages (created_at по умолчанию / relevance),
  enum MessageSearchSort. Влит в master 2026-06-18.

Пакеты: SDK 1.0.24, CLI 2026.6.2, n8n 2.0.12, generator 1.1.7
(releases.json + changelog'и + n8n README/DEVELOPMENT + пример pachca doctor).

Заодно из PENDING_DOC_FIXES (§3):
- Python SDK: фикс NameError в авто-ретрае на 429/5xx (generator
  _jitter → _add_jitter), перегенерированы снапшоты.
- generator.test.ts: dependency-free guard — каждый вызов приватного
  хелпера _name( в сгенерированном Python обязан иметь def _name(.

Прочее:
- docs/api-audit.md: раздел «Две ловушки сверки» (публичный namespace по
  base URL; проверять покрытие по пути API, не по угаданному имени модели).
- n8n contract.test.ts: скоуп regex enum-проверки на текст блока (две
  одноимённые query-param sort в messages/users больше не коллизируют).
@lookinway
lookinway force-pushed the api-audit-2026-06-19 branch from a177375 to 6ec4801 Compare June 19, 2026 14:47
@lookinway
lookinway merged commit 4c2a545 into main Jun 19, 2026
12 checks passed
@lookinway
lookinway deleted the api-audit-2026-06-19 branch June 19, 2026 14:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant