Дошка — тахтаи онлайн барои дарсҳо, вохӯриҳо ва кори дастаҷамъӣ
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-и ҷисми дархостро бо сирри обуна дорад — пеш аз бовар кардан ба дархост онро санҷед.
- Суроға — танҳо 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