Дошка — сабактар, жолугушуулар жана командалык иш үчүн онлайн-такта
Иштеп чыгуучулар үчүн Дошканын 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