Дошка — сабактар, жолугушуулар жана командалык иш үчүн онлайн-такта

Иштеп чыгуучулар үчүн Дошканын API’си

Өз программаларыңыздан такта түзүү, анын мазмунун окуу жана өзгөртүү үчүн REST API жана вебхуктар: трекердеги тапшырмалар жана CRMдеги бүтүмдөр стикер катары, фигуралар менен жебелерден схемалар, элементтерди оңдоо жана өчүрүү, жаңы стикерлер жана комментарийлер тууралуу окуялар. Формат — JSON, дарек — https://doshka-online.by/api/v1.

API ачкычы

Ар бир суроо Authorization: Bearer аталышы жана сиздин ачкыч менен жөнөтүлөт.

Ыкмалар

Стикер: 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'сине гана кайрылат: Дошка такталардын мазмунун нейротармактарга жөнөтпөйт, муну сиз тандаган жардамчы сиздин өтүнүчүңүз менен жасайт.

Вебхуктар

{
  "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