Дошка — сабақтарға, кездесулерге және командалық жұмысқа арналған онлайн-тақта
Әзірлеушілерге арналған Дошка 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: «Settings» → «Developer» → «Edit Config»; 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 мәні бар — сұрауға сенер алдында оны тексеріңіз.
- Мекенжай — тек 443 порттағы https, ішкі желіде емес, қайта бағыттаусыз; жауапты 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= және «Тек қарау» тақта сілтемесі. Жауап — iframe коды бар type rich. Қателер: 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