Дошка — онлайн-доска для занятий, встреч и командной работы
API Дошки для разработчиков
REST API и вебхуки, чтобы создавать доски, читать и менять их содержимое из своих программ: стикеры с задачами из трекера и сделками из CRM, схемы из фигур и стрелок, правка и удаление элементов, события о новых стикерах и комментариях. Формат — JSON, адрес — https://doshka-online.by/api/v1.
Ключ API
- Войдите в Дошку и на главной нажмите «Ключи API» → «Создать ключ».
- Ключ (начинается с dk_) показывается один раз — сохраните его как пароль.
- Ключ даёт те же права, что у его владельца: личные доски и доски его организаций.
- Утёкший или ненужный ключ удалите там же — запросы с ним сразу перестанут проходить.
Каждый запрос — с заголовком Authorization: Bearer и ваш ключ.
Методы
- GET /api/v1/me — владелец ключа: id, почта, имя.
- GET /api/v1/boards — доски: id, название, организация, дата создания.
- POST /api/v1/boards — создать доску; в теле можно передать title и orgId.
- GET /api/v1/boards/ID — доска и её элементы: тип, координаты, размер, текст, цвет стикера.
- PATCH /api/v1/boards/ID — переименовать доску: в теле title.
- POST /api/v1/boards/ID/stickers — добавить стикеры, до 100 за раз; без x и y они встанут рядами под всем, что уже есть на доске.
- POST /api/v1/boards/ID/elements — нарисовать фигуры, надписи и стрелки, до 200 за раз — подробнее в разделе «Схемы».
- PATCH /api/v1/boards/ID/elements/ID — изменить элемент: text, color, x, y, width, height, link — передайте только то, что меняется.
- DELETE /api/v1/boards/ID/elements/ID — удалить элемент вместе с подписью; привязанные стрелки остаются, но отвязываются.
- GET /api/v1/webhooks — ваши вебхуки и их состояние.
- POST /api/v1/webhooks — подписаться на события доски: boardId, адрес https://… вашего сервера и список events; в ответе секрет для проверки подписи (показывается один раз).
- DELETE /api/v1/webhooks/ID — отписаться.
Стикер: text, color и по желанию x, y. Цвета: yellow, green, blue, pink, orange, violet, red, teal, lime, cyan, gray, white.
Ограничение — 120 запросов в минуту на ключ, при превышении — ответ 429.
Пример: добавить стикер
curl, Python и JavaScript — один и тот же запрос.
curl -X POST https://doshka-online.by/api/v1/boards/BOARD_ID/stickers \
-H "Authorization: Bearer dk_..." \
-H "Content-Type: application/json" \
-d '{"stickers":[{"text":"PROJ-12 Login page","color":"pink"}]}'import requests
requests.post(
"https://doshka-online.by/api/v1/boards/BOARD_ID/stickers",
headers={"Authorization": "Bearer dk_..."},
json={"stickers": [{"text": "PROJ-12 Login page", "color": "pink"}]},
)await fetch("https://doshka-online.by/api/v1/boards/BOARD_ID/stickers", {
method: "POST",
headers: { Authorization: "Bearer dk_...", "Content-Type": "application/json" },
body: JSON.stringify({ stickers: [{ text: "PROJ-12 Login page", color: "pink" }] }),
});
Схемы: фигуры и стрелки
POST /api/v1/boards/ID/elements принимает список elements. type: sticker, rectangle, ellipse, diamond, text или arrow; text — подпись фигуры, стрелки или сама надпись; color — те же цвета, что у стикеров; x, y, width, height, link (только https://). Стрелка соединяет from и to — id элемента на доске или ref фигуры из того же запроса. Стрелки привязаны: двигают фигуру — стрелка едет следом. Если стрелка ссылается на несуществующий элемент, запрос отклоняется целиком и доска не меняется. С полем layout (right или down) фигуры без x и y раскладываются сами, как блок-схема: слоями по стрелкам под содержимым доски.
curl -X POST https://doshka-online.by/api/v1/boards/BOARD_ID/elements \
-H "Authorization: Bearer dk_..." \
-H "Content-Type: application/json" \
-d '{"layout":"right","elements":[
{"type":"rectangle","ref":"order","text":"Order","color":"blue"},
{"type":"diamond","ref":"paid","text":"Paid?"},
{"type":"ellipse","ref":"ship","text":"Ship","color":"green"},
{"type":"arrow","from":"order","to":"paid"},
{"type":"arrow","from":"paid","to":"ship","text":"yes"}
]}'Правка через PATCH двигает фигуру вместе с подписью и концами стрелок. Закреплённый на доске элемент API не меняет (ответ 409).
Узлы для n8n
Пакет n8n-nodes-doshka: узел «Doshka» создаёт и переименовывает доски, добавляет стикеры (элементы на входе уходят пачками по 100), рисует схемы с автоматической раскладкой, правит и удаляет элементы; узел «Doshka Trigger» запускает процесс, когда стикер создан, изменён или удалён, добавлен комментарий или доска изменилась, — подписку на вебхук n8n создаёт и удаляет сам и проверяет подпись каждого сообщения. Учётные данные Doshka API — ваш ключ. Для триггера адрес n8n должен быть доступен из интернета по https.
n8n → Settings → Community nodes → Install → n8n-nodes-doshka
MCP-сервер для ИИ-помощников
MCP (Model Context Protocol) — стандарт, по которому ИИ-помощники работают с внешними сервисами. С MCP-сервером Дошки можно попросить помощника: «разложи задачи из этого письма стикерами на новой доске» или «нарисуй схему процесса заказа» — и он сделает это сам и пришлёт ссылку на доску.
Как подключить: 1) создайте ключ API (главная Дошки → «Ключи API»); 2) установите Node.js 18 или новее; 3) скачайте файл https://doshka-online.by/doshka-mcp.mjs — это весь сервер, без других пакетов; 4) добавьте его в настройки помощника, как в примере ниже (Claude Desktop: «Настройки» → «Разработчик» → «Изменить конфигурацию»; Cursor: файл .cursor/mcp.json), вместо dk_... — ваш ключ, путь — где лежит файл. Проверка: node doshka-mcp.mjs --check.
{
"mcpServers": {
"doshka": {
"command": "node",
"args": ["C:\\Users\\me\\Downloads\\doshka-mcp.mjs"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Или без скачивания файла — из npm (пакет doshka-mcp), Node.js скачает его сам:
{
"mcpServers": {
"doshka": {
"command": "npx",
"args": ["-y", "doshka-mcp"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Claude Code — одной командой:
claude mcp add doshka -e DOSHKA_API_KEY=dk_... -- npx -y doshka-mcpИнструменты: list_boards, create_board, get_board, rename_board, add_stickers, draw_diagram (фигуры без координат раскладываются сами по стрелкам), update_element, delete_element. Сервер работает на вашем компьютере и обращается только к API Дошки с вашим ключом: Дошка не отправляет содержимое досок в нейросети, это делает выбранный вами помощник по вашей просьбе.
Вебхуки
- События: board.changed — сводка: сколько элементов добавили, изменили и удалили, сколько комментариев и кто правил; sticker.created, sticker.updated, sticker.deleted — сами стикеры: id, текст, цвет, место, ссылка; comment.added — текст комментария и элемент, к которому он оставлен. Без events приходит только board.changed.
- Правки за 5 секунд собираются: на каждое событие — один POST, в items до 100 записей, заголовок X-Doshka-Event — имя события. На этом удобно строить триггеры в n8n, Make и Zapier: «новый стикер → задача в трекере», «комментарий → сообщение в чат».
- Заголовок X-Doshka-Signature содержит sha256= и HMAC-SHA256 тела запроса с секретом подписки — сверьте его, прежде чем доверять запросу.
- Адрес — только https на порту 443, не во внутренней сети, без переадресаций; ответ ждём 5 секунд. После 20 неудач подряд подписка выключается. Не больше 20 вебхуков на учётную запись.
{
"boardId": "BOARD_ID",
"url": "https://example.com/doshka-hook",
"events": ["sticker.created", "comment.added"]
}{
"event": "sticker.created",
"boardId": "…",
"title": "…",
"at": "2026-11-16T10:00:00.000Z",
"by": ["…"],
"items": [{ "id": "…", "text": "PROJ-12 Login page", "color": "pink", "x": 320, "y": 240 }]
}Проверка подписи (Node.js):
import { createHmac, timingSafeEqual } from "node:crypto";
// rawBody — the raw request body (Buffer), secret — whsec_… from the subscription response
function isFromDoshka(rawBody, signature, secret) {
const expected = Buffer.from("sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex"));
const got = Buffer.from(String(signature ?? ""));
return got.length === expected.length && timingSafeEqual(got, expected);
}
Встраивание и oEmbed
Код iframe — в «Поделиться» → «Встроить на сайт». Встроенная доска только для просмотра и обновляется вживую.
oEmbed: GET /oembed?url= и ссылка на доску «Только просмотр». Ответ — type rich с кодом iframe. Ошибки: 404 — не ссылка на доску, 401 — доступ по ссылке выключен или на доске пароль.
Описание API для программ
Машиночитаемое описание API (OpenAPI 3.1) — его можно импортировать в Postman, n8n, Make и генераторы клиентов: https://doshka-online.by/openapi.json
Ошибки
Ответ с кодом не 2xx содержит поле error с текстом ошибки, у правки элементов — ещё code (missing, locked, geometry, color, link, text). 400 — неверное тело запроса, 401 — нет ключа или он неверный, 404 — доски или элемента нет либо к ним нет прав, 409 — элемент закреплён, 429 — слишком часто.
Справка · Инструкции · Вопросы и ответы · Переезд с Miro · Переезд с Holst · Дошка и другие онлайн-доски: честное сравнение · Поддерживаемые языки · Интеграции Дошки · API Дошки для разработчиков · О сервисе · Пользовательское соглашение · Политика конфиденциальности · Контакты · Лицензии · Шаблоны · Для кого · Статьи
Другие языки: Беларуская · Қазақша · Oʻzbekcha · Кыргызча · Тоҷикӣ · Հայերեն · Azərbaycanca · Română · Türkmençe · Latviešu · Lietuvių · Polski · Eesti · English