Doshka — sapaklar, duşuşyklar we topar işi üçin onlaýn tagta
Programmistler üçin Doshka API
Öz programmalaryňyzdan tagta döretmek, onuň mazmunyny okamak we üýtgetmek üçin REST API we webhuklar: trekerdäki meseleler we CRM-däki şertnamalar stiker görnüşinde, şekillerden we oklardan shemalar, elementleri redaktirlemek we pozmak, täze stikerler we teswirler barada wakalar. Format — JSON, salgy — https://doshka-online.by/api/v1.
API açary
- Doshka-a giriň we baş sahypada «API açarlary» → «Açar döret» düwmesine basyň.
- Açar (dk_ bilen başlaýar) bir gezek görkezilýär — ony açar söz ýaly saklaň.
- Açar eýesiniňki bilen deň hukuk berýär: şahsy tagtalar we onuň guramalarynyň tagtalary.
- Syzan ýa-da gereksiz açary şol ýerde pozuň — onuň bilen haýyşlar derrew geçmez.
Her haýyş Authorization: Bearer sözbaşysy we açaryňyz bilen iberilýär.
Usullar
- GET /api/v1/me — açaryň eýesi: id, poçta, at.
- GET /api/v1/boards — tagtalar: id, ady, gurama, döredilen senesi.
- POST /api/v1/boards — tagta döretmek; mazmunda title we orgId berip bolar.
- GET /api/v1/boards/ID — tagta we onuň elementleri: görnüşi, koordinatlary, ölçegi, teksti, stikeriň reňki.
- PATCH /api/v1/boards/ID — tagtanyň adyny üýtgetmek: bedeninde title.
- POST /api/v1/boards/ID/stickers — stiker goşmak, bir gezekde 100-e çenli; x we y bolmasa, olar tagtadaky ähli zadyň aşagynda hatar-hatar durýar.
- POST /api/v1/boards/ID/elements — şekilleri, ýazgylary we oklary çekmek, bir gezekde 200-e çenli — jikme-jik «Shemalar» bölüminde.
- PATCH /api/v1/boards/ID/elements/ID — elementi üýtgetmek: text, color, x, y, width, height, link — diňe üýtgeýänini iberiň.
- DELETE /api/v1/boards/ID/elements/ID — elementi ýazgysy bilen bilelikde pozmak; baglanan oklar galýar, emma aýrylýar.
- GET /api/v1/webhooks — webhuklaryňyz we olaryň ýagdaýy.
- POST /api/v1/webhooks — tagtanyň wakalaryna ýazylmak: boardId, serweriňiziň https://… salgysy we events sanawy; jogapda goly barlamak üçin gizlin açar bar (bir gezek görkezilýär).
- DELETE /api/v1/webhooks/ID — ýazylmany ýatyrmak.
Stiker: text, color we isleg boýunça x, y. Reňkler: yellow, green, blue, pink, orange, violet, red, teal, lime, cyan, gray, white.
Çäk — bir açara minutda 120 haýyş, artsa — 429 jogaby.
Mysal: stiker goşmak
curl, Python we JavaScript — şol bir haýyş.
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" }] }),
});
Shemalar: şekiller we oklar
POST /api/v1/boards/ID/elements elements sanawyny kabul edýär. type: sticker, rectangle, ellipse, diamond, text ýa-da arrow; text — şekiliň, okuň ýazgysy ýa-da ýazgynyň özi; color — stikerleriň reňkleri; x, y, width, height, link (diňe https://). Ok from we to-ny birleşdirýär — tagtadaky elementiň id-si ýa-da şol sorawdaky şekiliň ref-i. Oklar baglanan: şekili süýşürseler, ok onuň yzyndan gidýär. Ok ýok elemente salgylansa, soraw doly ret edilýär we tagta üýtgemeýär. layout meýdany bilen (right ýa-da down) x we y-siz şekiller blok-shema ýaly özi ýerleşýär: tagtanyň mazmunynyň aşagynda oklar boýunça gatlak-gatlak.
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 arkaly redaktirleme şekili ýazgysy we oklaryň uçlary bilen bilelikde süýşürýär. Tagtada berkidilen elementi API üýtgetmeýär (jogap 409).
n8n düwünleri
n8n-nodes-doshka paketi: «Doshka» düwüni tagta döredýär we adyny üýtgedýär, stiker goşýar (giriş elementleri 100-den bukjalap iberilýär), awtomatik ýerleşýän shemalary çekýär, elementleri redaktirleýär we pozýar; «Doshka Trigger» düwüni stiker döredilende, üýtgedilende ýa-da pozulanda, teswir goşulanda ýa-da tagta üýtgände prosesi başladýar — webhuka ýazylmagy n8n özi döredýär we pozýar hem-de her habaryň goluny barlaýar. Doshka API hasap maglumatlary — açaryňyz. Trigger üçin n8n salgysy internetden https arkaly elýeterli bolmaly.
n8n → Settings → Community nodes → Install → n8n-nodes-doshka
EA kömekçileri üçin MCP-serwer
MCP (Model Context Protocol) — EA kömekçileriniň daşarky hyzmatlar bilen işleýän standarty. Doshka MCP-serweri bilen kömekçiden «bu hatdaky meseleleri täze tagtada stiker edip ýerleşdir» ýa-da «sargyt prosesiniň shemasyny çek» diýip haýyş edip bolýar — ol muny özi edip, tagtanyň salgylanmasyny iberer.
Nädip birikdirmeli: 1) API açaryny dörediň (Doshka-nyň baş sahypasy → «API açarlary»); 2) Node.js 18 ýa-da täzesini guruň; 3) https://doshka-online.by/doshka-mcp.mjs faýlyny ýükläň — bu bütin serwer, başga paketsiz; 4) ony aşakdaky mysaldaky ýaly kömekçiniň sazlamalaryna goşuň (Claude Desktop: «Settings» → «Developer» → «Edit Config»; Cursor: .cursor/mcp.json faýly), dk_... ýerine — açaryňyz, ýol — faýlyň duran ýeri. Barlag: node doshka-mcp.mjs --check.
{
"mcpServers": {
"doshka": {
"command": "node",
"args": ["C:\\Users\\me\\Downloads\\doshka-mcp.mjs"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Ýa-da faýly ýüklemezden — npm arkaly (doshka-mcp bukjasy), Node.js ony özi ýükleýär:
{
"mcpServers": {
"doshka": {
"command": "npx",
"args": ["-y", "doshka-mcp"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Claude Code — bir buýruk bilen:
claude mcp add doshka -e DOSHKA_API_KEY=dk_... -- npx -y doshka-mcpGurallar: list_boards, create_board, get_board, rename_board, add_stickers, draw_diagram (koordinatasyz şekiller oklar boýunça özi ýerleşýär), update_element, delete_element. Serwer kompýuteriňizde işleýär we diňe açaryňyz bilen Doshka API-sine ýüz tutýar: Doshka tagtalaryň mazmunyny neýron torlaryna ibermeýär, muny siziň saýlan kömekçiňiz haýyşyňyz boýunça edýär.
Webhuklar
- Wakalar: board.changed — jemleme: näçe element goşuldy, üýtgedildi we pozuldy, näçe teswir we kim redaktirledi; sticker.created, sticker.updated, sticker.deleted — stikerleriň özi: id, tekst, reňk, ýer, salgylanma; comment.added — teswiriň teksti we onuň galdyrylan elementi. events bolmasa, diňe board.changed gelýär.
- 5 sekuntdaky üýtgeşmeler toplanýar: her waka — bir POST, items-de 100-e çenli ýazgy, X-Doshka-Event sözbaşysynda — wakanyň ady. Munuň bilen n8n, Make we Zapier-de trigger gurmak amatly: «täze stiker → trekerde mesele», «teswir → çata habar».
- X-Doshka-Signature sözbaşysynda sha256= we ýazylmanyň gizlin açary bilen haýyş mazmunynyň HMAC-SHA256 bahasy bar — haýyşa ynanmazdan öň ony barlaň.
- Salgy — diňe 443 portda https, içki ulgamda däl, gönükdirmesiz; jogaby 5 sekunt garaşýarys. Yzygiderli 20 şowsuzlykdan soň ýazylma öçürilýär. Bir hasaba 20-den köp bolmadyk webhuk.
{
"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 }]
}Goly barlamak (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);
}
Ýerleşdirme we oEmbed
iframe kody — «Paýlaş» → «Saýta ýerleşdir» bölüminde. Ýerleşdirilen tagta diňe görmek üçin we göni täzelenýär.
oEmbed: GET /oembed?url= we «Diňe görmek» tagta salgylanmasy. Jogap — iframe kody bilen type rich. Ýalňyşlar: 404 — tagta salgylanmasy däl, 401 — salgylanma boýunça giriş öçürilen ýa-da tagtada açar söz bar.
Programmalar üçin API beýany
API-niň maşyn okap bilýän beýany (OpenAPI 3.1) — ony Postman, n8n, Make we müşderi generatorlaryna import edip bolýar: https://doshka-online.by/openapi.json
Ýalňyşlar
Kody 2xx bolmadyk jogapda ýalňyşlygyň teksti bilen error meýdany bolýar, elementleri redaktirlemekde — ýene-de code (missing, locked, geometry, color, link, text). 400 — soragyň bedeni nädogry, 401 — açar ýok ýa-da nädogry, 404 — tagta ýa-da element ýok ýa-da olara hukuk ýok, 409 — element berkidilen, 429 — gaty ýygy.
Kömek · Gollanmalar · Soraglar we jogaplar · Miro-dan göçmek · Holst-dan göçmek · Doshka we beýleki onlaýn tagtalar: dogruçyl deňeşdirme · Goldaw berilýän diller · Doshka integrasiýalary · Programmistler üçin Doshka API · Hyzmat barada · Ulanyjy ylalaşygy · Gizlinlik syýasaty · Habarlaşmak · Ygtyýarnamalar · Şablonlar · Kim üçin · Makalalar
Beýleki diller: Русский · Беларуская · Қазақша · Oʻzbekcha · Кыргызча · Тоҷикӣ · Հայերեն · Azərbaycanca · Română · Latviešu · Lietuvių · Polski · Eesti · English