Դոշկա — առցանց գրատախտակ դասերի, հանդիպումների և թիմային աշխատանքի համար
Դոշկայի 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