Эндпоинты

Получить доску в Markdown

Возвращает доску в Markdown: колонки, карточки, голоса и комментарии. Дайте этот URL AI-агенту, чтобы превратить ретро в список задач. Аутентификация не требуется — доступ по коду доски.

GET /api/v1/boards/{boardId}/export.md

# Sprint 42

## Went Well

- CI is finally green — *Maria* [3 likes]
  - Huge relief! — *Peter*

Ссылка = доступ. Доска вне пространства и доска в пространстве без пароля открыты любому, кто знает их код, — так же, как сама страница доски. Если у пространства есть пароль, он закрывает и его доски: нужен заголовок X-Space-Password.

Ключи колонок зависят от формата доски (board.format). У классической доски это went_well, didnt_go_well и improve; у остальных форматов — свои id колонок, например wind, anchors, rocks, island у Sailboat.

Параметры

?lang=en|ru — язык заголовков разделов в Markdown: en (по умолчанию) или ru

X-Space-Password — пароль пространства, если оно закрыто (для его досок — тоже)

Лимиты и ошибки

30 запросов в минуту с одного IP — при превышении 429
Неизвестный код доски — 404
Закрыто паролем, а заголовка нет — 401; неверный пароль — 403