Doshka — internetinė lenta pamokoms, susitikimams ir komandiniam darbui
Doshka API kūrėjams
REST API ir žiniatinklio kabliai, kad iš savo programų galėtumėte kurti lentas, skaityti ir keisti jų turinį: lapeliai su užduotimis iš sekimo sistemos ir sandoriais iš CRM, schemos iš figūrų ir rodyklių, elementų taisymas ir trynimas, įvykiai apie naujus lapelius ir komentarus. Formatas: JSON; adresas: https://doshka-online.by/api/v1.
API raktas
- Prisijunkite prie Doshka ir pradiniame puslapyje spauskite «API raktai» → «Sukurti raktą».
- Raktas (prasideda dk_) parodomas vieną kartą — saugokite jį kaip slaptažodį.
- Raktas suteikia tas pačias teises kaip jo savininkui: asmenines lentas ir jo organizacijų lentas.
- Nutekėjusį ar nereikalingą raktą ištrinkite ten pat — užklausos su juo iškart nebepraeis.
Kiekvieną užklausą siųskite su antrašte Authorization: Bearer ir savo raktu.
Metodai
- GET /api/v1/me — rakto savininkas: id, el. paštas, vardas.
- GET /api/v1/boards — lentos: id, pavadinimas, organizacija, sukūrimo data.
- POST /api/v1/boards — sukurti lentą; turinyje galima perduoti title ir orgId.
- GET /api/v1/boards/ID — lenta ir jos elementai: tipas, koordinatės, dydis, tekstas, lapelio spalva.
- PATCH /api/v1/boards/ID — pervadinti lentą: užklausos turinyje title.
- POST /api/v1/boards/ID/stickers — pridėti lapelius, iki 100 vienu kartu; be x ir y jie išsirikiuoja eilėmis po viskuo, kas jau yra lentoje.
- POST /api/v1/boards/ID/elements — piešti figūras, užrašus ir rodykles, iki 200 vienu kartu; daugiau skyriuje „Schemos“.
- PATCH /api/v1/boards/ID/elements/ID — pakeisti elementą: text, color, x, y, width, height, link; siųskite tik tai, kas keičiasi.
- DELETE /api/v1/boards/ID/elements/ID — ištrinti elementą kartu su jo užrašu; pririštos rodyklės lieka, bet atsiejamos.
- GET /api/v1/webhooks — jūsų žiniatinklio kabliai ir jų būsena.
- POST /api/v1/webhooks — užsiprenumeruoti lentos įvykius: boardId, jūsų serverio https://… adresas ir events sąrašas; atsakyme yra paslaptis parašui tikrinti (rodoma vieną kartą).
- DELETE /api/v1/webhooks/ID — atsisakyti prenumeratos.
Lapelis: text, color ir pasirinktinai x, y. Spalvos: yellow, green, blue, pink, orange, violet, red, teal, lime, cyan, gray, white.
Apribojimas — 120 užklausų per minutę vienam raktui, viršijus — atsakymas 429.
Pavyzdys: pridėti lapelį
curl, Python ir JavaScript — ta pati užklausa.
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" }] }),
});
Schemos: figūros ir rodyklės
POST /api/v1/boards/ID/elements priima elements sąrašą. type: sticker, rectangle, ellipse, diamond, text arba arrow; text yra figūros ar rodyklės užrašas arba pats užrašas; color — tos pačios spalvos kaip lapelių; x, y, width, height, link (tik https://). Rodyklė jungia from ir to: lentos elemento id arba tos pačios užklausos figūros ref. Rodyklės lieka pririštos: patraukus figūrą, rodyklė seka paskui. Jei rodyklė rodo į neegzistuojantį elementą, visa užklausa atmetama ir lenta nesikeičia. Su lauku layout (right arba down) figūros be x ir y išsidėsto pačios kaip blokinė schema: sluoksniais pagal rodykles po lentos turiniu.
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"}
]}'Taisant per PATCH figūra pasislenka kartu su užrašu ir rodyklių galais. Lentoje prisegto elemento API nekeičia (atsakymas 409).
n8n mazgai
Paketas n8n-nodes-doshka: mazgas Doshka kuria ir pervadina lentas, prideda lapelius (įvesties elementai siunčiami po 100), braižo schemas su automatiniu išdėstymu, taiso ir trina elementus; mazgas Doshka Trigger paleidžia procesą, kai lapelis sukuriamas, pakeičiamas ar ištrinamas, pridedamas komentaras arba pasikeičia lenta. n8n pats sukuria ir pašalina žiniatinklio kablio prenumeratą ir tikrina kiekvieno pranešimo parašą. Doshka API prisijungimo duomenyse — jūsų raktas. Trigeriui n8n turi būti pasiekiamas iš interneto per https.
n8n → Settings → Community nodes → Install → n8n-nodes-doshka
MCP serveris DI asistentams
MCP (Model Context Protocol) yra standartas, kuriuo DI asistentai dirba su kitomis paslaugomis. Su Doshka MCP serveriu galite paprašyti asistento „išdėliok šio laiško užduotis lapeliais naujoje lentoje“ arba „nubraižyk užsakymo proceso schemą“, ir jis tai padarys pats bei atsiųs lentos nuorodą.
Kaip prijungti: 1) sukurkite API raktą (Doshka pradžios puslapis → API raktai); 2) įdiekite Node.js 18 ar naujesnę; 3) atsisiųskite https://doshka-online.by/doshka-mcp.mjs — šis vienas failas yra visas serveris, be kitų paketų; 4) įtraukite jį į asistento nustatymus kaip pavyzdyje žemiau (Claude Desktop: Settings → Developer → Edit Config; Cursor: failas .cursor/mcp.json), vietoj dk_... — jūsų raktas, kelias — kur išsaugojote failą. Patikra: node doshka-mcp.mjs --check.
{
"mcpServers": {
"doshka": {
"command": "node",
"args": ["C:\\Users\\me\\Downloads\\doshka-mcp.mjs"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Arba nesisiunčiant failo — iš npm (paketas doshka-mcp), Node.js jį atsisiųs pats:
{
"mcpServers": {
"doshka": {
"command": "npx",
"args": ["-y", "doshka-mcp"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Claude Code — viena komanda:
claude mcp add doshka -e DOSHKA_API_KEY=dk_... -- npx -y doshka-mcpĮrankiai: list_boards, create_board, get_board, rename_board, add_stickers, draw_diagram (figūros be koordinačių išsidėsto pačios pagal rodykles), update_element, delete_element. Serveris veikia jūsų kompiuteryje ir kreipiasi tik į Doshka API su jūsų raktu: Doshka nesiunčia lentų turinio DI paslaugoms, tai daro jūsų pasirinktas asistentas jūsų prašymu.
Žiniatinklio kabliai
- Įvykiai: board.changed yra suvestinė: kiek elementų pridėta, pakeista ir ištrinta, kiek komentarų ir kas taisė; sticker.created, sticker.updated, sticker.deleted pateikia pačius lapelius: id, tekstą, spalvą, vietą, nuorodą; comment.added pateikia komentaro tekstą ir elementą, prie kurio jis paliktas. Be events siunčiamas tik board.changed.
- Pakeitimai per 5 sekundes sujungiami: kiekvienam įvykiui vienas POST, items iki 100 įrašų, antraštėje X-Doshka-Event yra įvykio pavadinimas. Taip patogu kurti trigerius n8n, Make ir Zapier: „naujas lapelis → užduotis sekimo sistemoje“, „komentaras → žinutė pokalbyje“.
- Antraštėje X-Doshka-Signature yra sha256= ir užklausos turinio HMAC-SHA256 su prenumeratos paslaptimi — patikrinkite jį prieš pasitikėdami užklausa.
- Adresas — tik https per 443 prievadą, ne vidiniame tinkle, be peradresavimų; atsakymo laukiame 5 sekundes. Po 20 nesėkmių iš eilės prenumerata išjungiama. Ne daugiau kaip 20 žiniatinklio kablių vienai paskyrai.
{
"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 }]
}Parašo tikrinimas (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);
}
Įterpimas ir oEmbed
iframe kodas — skiltyje «Bendrinti» → «Įterpti į svetainę». Įterpta lenta skirta tik peržiūrai ir atsinaujina tiesiogiai.
oEmbed: GET /oembed?url= ir lentos nuoroda «Tik peržiūra». Atsakymas — type rich su iframe kodu. Klaidos: 404 — tai ne lentos nuoroda, 401 — prieiga per nuorodą išjungta arba lenta turi slaptažodį.
API aprašas programoms
Mašinomis skaitomas API aprašas (OpenAPI 3.1), kurį galima importuoti į Postman, n8n, Make ir klientų generatorius: https://doshka-online.by/openapi.json
Klaidos
Atsakyme, kurio kodas ne 2xx, yra laukas error su klaidos tekstu, taisant elementus dar ir code (missing, locked, geometry, color, link, text). 400: netinkamas užklausos turinys; 401: nėra rakto arba jis netinkamas; 404: lentos ar elemento nėra arba neturite prieigos; 409: elementas prisegtas; 429: per dažnai.
Pagalba · Instrukcijos · Klausimai ir atsakymai · Perėjimas iš Miro · Persikraustymas iš Holst · Doshka ir kitos internetinės lentos: sąžiningas palyginimas · Palaikomos kalbos · Doshka integracijos · Doshka API kūrėjams · Apie paslaugą · Naudojimo sąlygos · Privatumo politika · Kontaktai · Licencijos · Šablonai · Panaudojimas · Straipsniai
Kitos kalbos: Русский · Беларуская · Қазақша · Oʻzbekcha · Кыргызча · Тоҷикӣ · Հայերեն · Azərbaycanca · Română · Türkmençe · Latviešu · Polski · Eesti · English