Դոշկա — առցանց գրատախտակ դասերի, հանդիպումների և թիմային աշխատանքի համար

Դոշկայի 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= և «Միայն դիտում» գրատախտակի հղումը։ Պատասխանը՝ 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