Doshka — veebitahvel tundideks, koosolekuteks ja meeskonnatööks
Doshka API arendajatele
REST API ja veebikonksud, et oma programmidest tahvleid luua ning nende sisu lugeda ja muuta: kleebismärkmed jälgimissüsteemi ülesannete ja CRM-i tehingutega, skeemid kujunditest ja nooltest, elementide muutmine ja kustutamine, sündmused uute märkmete ja kommentaaride kohta. Vorming: JSON; aadress: https://doshka-online.by/api/v1.
API-võti
- Logige Doshkasse sisse ja vajutage avalehel «API-võtmed» → «Loo võti».
- Võtit (algab dk_) näidatakse üks kord — hoidke seda nagu parooli.
- Võtmel on samad õigused nagu selle omanikul: isiklikud tahvlid ja tema organisatsioonide tahvlid.
- Lekkinud või mittevajaliku võtme kustutage samas kohas — päringud sellega lakkavad kohe toimimast.
Saatke iga päring päisega Authorization: Bearer ja oma võtmega.
Meetodid
- GET /api/v1/me — võtme omanik: id, e-post, nimi.
- GET /api/v1/boards — tahvlid: id, nimi, organisatsioon, loomise kuupäev.
- POST /api/v1/boards — loo tahvel; päringu sisus võib anda title ja orgId.
- GET /api/v1/boards/ID — tahvel ja selle elemendid: tüüp, koordinaadid, suurus, tekst, kleebismärkme värv.
- PATCH /api/v1/boards/ID — tahvli ümbernimetamine: päringu kehas title.
- POST /api/v1/boards/ID/stickers — lisa kleebismärkmeid, kuni 100 korraga; ilma x ja y väärtuseta paigutuvad need ridadesse kõige tahvlil oleva alla.
- POST /api/v1/boards/ID/elements — kujundite, tekstide ja noolte joonistamine, kuni 200 korraga; täpsemalt jaotises „Skeemid”.
- PATCH /api/v1/boards/ID/elements/ID — elemendi muutmine: text, color, x, y, width, height, link; saatke ainult see, mis muutub.
- DELETE /api/v1/boards/ID/elements/ID — elemendi kustutamine koos selle sildiga; seotud nooled jäävad alles, kuid vabastatakse.
- GET /api/v1/webhooks — teie veebikonksud ja nende olek.
- POST /api/v1/webhooks — tahvli sündmuste tellimine: boardId, teie serveri https://… aadress ja events loend; vastuses on saladus allkirja kontrollimiseks (näidatakse üks kord).
- DELETE /api/v1/webhooks/ID — loobu tellimusest.
Kleebismärge: text, color ja soovi korral x, y. Värvid: yellow, green, blue, pink, orange, violet, red, teal, lime, cyan, gray, white.
Piirang — 120 päringut minutis ühe võtme kohta; ületamisel vastus 429.
Näide: lisa kleebismärge
curl, Python ja JavaScript — üks ja sama päring.
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" }] }),
});
Skeemid: kujundid ja nooled
POST /api/v1/boards/ID/elements võtab vastu elements loendi. type: sticker, rectangle, ellipse, diamond, text või arrow; text on kujundi või noole silt või tekst ise; color — samad värvid mis märkmetel; x, y, width, height, link (ainult https://). Nool ühendab from ja to: tahvlil oleva elemendi id või sama päringu kujundi ref. Nooled jäävad seotuks: kujundit liigutades liigub nool kaasa. Kui nool viitab olematule elemendile, lükatakse kogu päring tagasi ja tahvel ei muutu. Väljaga layout (right või down) paigutuvad kujundid ilma x ja y-ta ise nagu plokkskeem: kihtidena noolte järgi tahvli sisu alla.
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 liigutab kujundit koos sildi ja noolte otstega. Tahvlile kinnitatud elementi API ei muuda (vastus 409).
n8n sõlmed
Pakett n8n-nodes-doshka: sõlm Doshka loob ja nimetab ümber tahvleid, lisab kleebismärkmeid (sisendelemendid saadetakse 100 kaupa), joonistab automaatse paigutusega skeeme, muudab ja kustutab elemente; sõlm Doshka Trigger käivitab töövoo, kui märge luuakse, muudetakse või kustutatakse, lisatakse kommentaar või tahvel muutub. n8n loob ja eemaldab veebikonksu tellimuse ise ning kontrollib iga sõnumi allkirja. Doshka API mandaatidesse käib teie võti. Päästiku jaoks peab n8n olema internetist https kaudu kättesaadav.
n8n → Settings → Community nodes → Install → n8n-nodes-doshka
MCP-server tehisintellekti abilistele
MCP (Model Context Protocol) on standard, mille abil tehisintellekti abilised töötavad teiste teenustega. Doshka MCP-serveriga saate abiliselt paluda: „pane selle kirja ülesanded märkmetena uuele tahvlile” või „joonista tellimisprotsessi skeem”, ja ta teeb selle ise ning saadab tahvli lingi.
Kuidas ühendada: 1) looge API-võti (Doshka avaleht → API-võtmed); 2) paigaldage Node.js 18 või uuem; 3) laadige alla https://doshka-online.by/doshka-mcp.mjs — see üks fail ongi kogu server, ilma muude pakettideta; 4) lisage see abilise seadetesse nagu allolevas näites (Claude Desktop: Settings → Developer → Edit Config; Cursor: fail .cursor/mcp.json), dk_... asemel teie võti, tee — kuhu faili salvestasite. Kontroll: node doshka-mcp.mjs --check.
{
"mcpServers": {
"doshka": {
"command": "node",
"args": ["C:\\Users\\me\\Downloads\\doshka-mcp.mjs"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Või ilma faili alla laadimata — npm-ist (pakett doshka-mcp), Node.js laadib selle ise:
{
"mcpServers": {
"doshka": {
"command": "npx",
"args": ["-y", "doshka-mcp"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Claude Code — ühe käsuga:
claude mcp add doshka -e DOSHKA_API_KEY=dk_... -- npx -y doshka-mcpTööriistad: list_boards, create_board, get_board, rename_board, add_stickers, draw_diagram (koordinaatideta kujundid paigutuvad noolte järgi ise), update_element, delete_element. Server töötab teie arvutis ja suhtleb ainult Doshka API-ga teie võtmega: Doshka ei saada tahvlite sisu tehisintellekti teenustele, seda teeb teie valitud abiline teie palvel.
Veebikonksud
- Sündmused: board.changed on kokkuvõte: mitu elementi lisati, muudeti ja kustutati, mitu kommentaari ja kes muutis; sticker.created, sticker.updated, sticker.deleted sisaldavad märkmeid endid: id, tekst, värv, asukoht, link; comment.added sisaldab kommentaari teksti ja elementi, mille juurde see jäeti. Ilma events-ita saadetakse ainult board.changed.
- 5 sekundi muudatused koondatakse: iga sündmuse kohta üks POST, items-is kuni 100 kirjet ja päises X-Doshka-Event on sündmuse nimi. Nii on mugav luua päästikuid n8n-is, Make'is ja Zapieris: „uus märge → ülesanne jälgimissüsteemis”, „kommentaar → sõnum vestlusesse”.
- Päis X-Doshka-Signature sisaldab sha256= ja päringu sisu HMAC-SHA256 väärtust tellimuse saladusega — kontrollige seda enne päringut usaldama hakkamist.
- Aadress — ainult https pordil 443, mitte sisevõrgus, ilma ümbersuunamisteta; vastust ootame 5 sekundit. Pärast 20 järjestikust nurjumist tellimus lülitatakse välja. Kuni 20 veebikonksu konto kohta.
{
"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 }]
}Allkirja kontrollimine (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);
}
Manustamine ja oEmbed
iframe-kood on menüüs «Jaga» → «Manusta veebilehele». Manustatud tahvel on ainult vaatamiseks ja uueneb reaalajas.
oEmbed: GET /oembed?url= ja tahvli link «Ainult vaatamine». Vastus — type rich koos iframe-koodiga. Vead: 404 — see pole tahvli link, 401 — lingiga juurdepääs on välja lülitatud või tahvlil on parool.
API kirjeldus programmidele
Masinloetav API kirjeldus (OpenAPI 3.1), mida saab importida Postmani, n8n-i, Make’i ja klienditeekide generaatoritesse: https://doshka-online.by/openapi.json
Vead
Vastus, mille kood pole 2xx, sisaldab välja error veateatega, elementide muutmisel ka code (missing, locked, geometry, color, link, text). 400: vigane päringu keha; 401: võti puudub või on vale; 404: tahvlit või elementi pole või teil pole õigusi; 409: element on kinnitatud; 429: liiga sageli.
Abi · Juhendid · Küsimused ja vastused · Üleminek Mirost · Kolimine Holstist · Doshka ja teised veebitahvlid: aus võrdlus · Toetatud keeled · Doshka integratsioonid · Doshka API arendajatele · Teenusest · Kasutustingimused · Privaatsuspoliitika · Kontaktid · Litsentsid · Mallid · Kasutusjuhud · Artiklid
Teised keeled: Русский · Беларуская · Қазақша · Oʻzbekcha · Кыргызча · Тоҷикӣ · Հայերեն · Azərbaycanca · Română · Türkmençe · Latviešu · Lietuvių · Polski · English