Doshka — tiešsaistes tāfele nodarbībām, sanāksmēm un komandas darbam
Doshka API izstrādātājiem
REST API un tīmekļa āķi, lai no savām programmām veidotu tāfeles, lasītu un mainītu to saturu: līmlapiņas ar uzdevumiem no trekera un darījumiem no CRM, shēmas no figūrām un bultām, elementu labošana un dzēšana, notikumi par jaunām līmlapiņām un komentāriem. Formāts: JSON; adrese: https://doshka-online.by/api/v1.
API atslēga
- Piesakieties Doshka un sākumlapā nospiediet «API atslēgas» → «Izveidot atslēgu».
- Atslēga (sākas ar dk_) tiek parādīta vienu reizi — glabājiet to kā paroli.
- Atslēgai ir tādas pašas tiesības kā tās īpašniekam: personīgās tāfeles un viņa organizāciju tāfeles.
- Noplūdušu vai nevajadzīgu atslēgu dzēsiet turpat — pieprasījumi ar to uzreiz vairs netiks izpildīti.
Katru pieprasījumu sūtiet ar galveni Authorization: Bearer un savu atslēgu.
Metodes
- GET /api/v1/me — atslēgas īpašnieks: id, e-pasts, vārds.
- GET /api/v1/boards — tāfeles: id, nosaukums, organizācija, izveides datums.
- POST /api/v1/boards — izveidot tāfeli; pamattekstā var nodot title un orgId.
- GET /api/v1/boards/ID — tāfele un tās elementi: tips, koordinātas, izmērs, teksts, līmlapiņas krāsa.
- PATCH /api/v1/boards/ID — pārdēvēt tāfeli: pieprasījuma ķermenī title.
- POST /api/v1/boards/ID/stickers — pievienot līmlapiņas, līdz 100 vienā reizē; bez x un y tās nostājas rindās zem visa, kas jau ir uz tāfeles.
- POST /api/v1/boards/ID/elements — zīmēt figūras, uzrakstus un bultas, līdz 200 vienā reizē; sīkāk sadaļā “Shēmas”.
- PATCH /api/v1/boards/ID/elements/ID — mainīt elementu: text, color, x, y, width, height, link; sūtiet tikai to, kas mainās.
- DELETE /api/v1/boards/ID/elements/ID — dzēst elementu kopā ar tā uzrakstu; piesaistītās bultas paliek, bet tiek atvienotas.
- GET /api/v1/webhooks — jūsu tīmekļa āķi un to stāvoklis.
- POST /api/v1/webhooks — abonēt tāfeles notikumus: boardId, jūsu servera https://… adrese un events saraksts; atbildē ir noslēpums paraksta pārbaudei (tiek parādīts vienreiz).
- DELETE /api/v1/webhooks/ID — atteikties no abonementa.
Līmlapiņa: text, color un pēc izvēles x, y. Krāsas: yellow, green, blue, pink, orange, violet, red, teal, lime, cyan, gray, white.
Ierobežojums — 120 pieprasījumi minūtē vienai atslēgai, pārsniedzot — atbilde 429.
Piemērs: pievienot līmlapiņu
curl, Python un JavaScript — viens un tas pats pieprasījums.
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" }] }),
});
Shēmas: figūras un bultas
POST /api/v1/boards/ID/elements pieņem elements sarakstu. type: sticker, rectangle, ellipse, diamond, text vai arrow; text ir figūras vai bultas uzraksts vai pats uzraksts; color — tās pašas krāsas kā līmlapiņām; x, y, width, height, link (tikai https://). Bulta savieno from un to: elementa id uz tāfeles vai figūras ref no tā paša pieprasījuma. Bultas paliek piesaistītas: pārvietojot figūru, bulta seko. Ja bulta norāda uz neesošu elementu, viss pieprasījums tiek noraidīts un tāfele nemainās. Ar lauku layout (right vai down) figūras bez x un y izkārtojas pašas kā blokshēma: slāņos pa bultām zem tāfeles satura.
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"}
]}'Labojot ar PATCH, figūra pārvietojas kopā ar uzrakstu un bultu galiem. Uz tāfeles piestiprinātu elementu API nemaina (atbilde 409).
n8n mezgli
Pakotne n8n-nodes-doshka: mezgls Doshka izveido un pārdēvē tāfeles, pievieno līmlapiņas (ievades elementi tiek sūtīti pa 100), zīmē shēmas ar automātisku izkārtojumu, labo un dzēš elementus; mezgls Doshka Trigger palaiž procesu, kad līmlapiņa izveidota, mainīta vai dzēsta, pievienots komentārs vai tāfele mainījusies. n8n pats izveido un dzēš tīmekļa āķa abonementu un pārbauda katra ziņojuma parakstu. Doshka API akreditācijas datos — jūsu atslēga. Trigerim n8n jābūt pieejamam no interneta ar https.
n8n → Settings → Community nodes → Install → n8n-nodes-doshka
MCP serveris MI asistentiem
MCP (Model Context Protocol) ir standarts, ar kuru MI asistenti strādā ar citiem pakalpojumiem. Ar Doshka MCP serveri varat palūgt asistentam “saliec šī e-pasta uzdevumus līmlapiņās uz jaunas tāfeles” vai “uzzīmē pasūtījuma procesa shēmu”, un tas to izdarīs pats un atsūtīs tāfeles saiti.
Kā pieslēgt: 1) izveidojiet API atslēgu (Doshka sākumlapa → API atslēgas); 2) instalējiet Node.js 18 vai jaunāku; 3) lejupielādējiet https://doshka-online.by/doshka-mcp.mjs — šis viens fails ir viss serveris, bez citām pakotnēm; 4) pievienojiet to asistenta iestatījumos kā piemērā zemāk (Claude Desktop: Settings → Developer → Edit Config; Cursor: fails .cursor/mcp.json), dk_... vietā — jūsu atslēga, ceļš — kur saglabājāt failu. Pārbaude: node doshka-mcp.mjs --check.
{
"mcpServers": {
"doshka": {
"command": "node",
"args": ["C:\\Users\\me\\Downloads\\doshka-mcp.mjs"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Vai bez faila lejupielādes — no npm (pakotne doshka-mcp), Node.js to lejupielādēs pats:
{
"mcpServers": {
"doshka": {
"command": "npx",
"args": ["-y", "doshka-mcp"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Claude Code — ar vienu komandu:
claude mcp add doshka -e DOSHKA_API_KEY=dk_... -- npx -y doshka-mcpRīki: list_boards, create_board, get_board, rename_board, add_stickers, draw_diagram (figūras bez koordinātām izkārtojas pašas pa bultām), update_element, delete_element. Serveris darbojas jūsu datorā un sazinās tikai ar Doshka API ar jūsu atslēgu: Doshka nesūta tāfeļu saturu MI pakalpojumiem, to dara jūsu izvēlētais asistents pēc jūsu lūguma.
Tīmekļa āķi
- Notikumi: board.changed ir kopsavilkums: cik elementu pievienots, mainīts un dzēsts, cik komentāru un kurš labojis; sticker.created, sticker.updated, sticker.deleted satur pašas līmlapiņas: id, tekstu, krāsu, vietu, saiti; comment.added satur komentāra tekstu un elementu, pie kura tas atstāts. Bez events tiek sūtīts tikai board.changed.
- Izmaiņas 5 sekundēs tiek apkopotas: katram notikumam viens POST, items līdz 100 ierakstiem, galvenē X-Doshka-Event ir notikuma nosaukums. Tā ir ērti veidot trigerus n8n, Make un Zapier: “jauna līmlapiņa → uzdevums trekerī”, “komentārs → ziņa tērzēšanā”.
- Galvene X-Doshka-Signature satur sha256= un pieprasījuma pamatteksta HMAC-SHA256 ar abonementa noslēpumu — pārbaudiet to, pirms uzticaties pieprasījumam.
- Adrese — tikai https uz porta 443, ne iekšējā tīklā, bez pāradresācijām; atbildi gaidām 5 sekundes. Pēc 20 neveiksmēm pēc kārtas abonements tiek izslēgts. Ne vairāk kā 20 tīmekļa āķi vienam kontam.
{
"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 }]
}Paraksta pārbaude (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);
}
Iegulšana un oEmbed
iframe kods ir sadaļā «Kopīgot» → «Iegult vietnē». Iegultā tāfele ir tikai skatīšanai un atjaunojas tiešsaistē.
oEmbed: GET /oembed?url= un tāfeles saite «Tikai skatīties». Atbilde — type rich ar iframe kodu. Kļūdas: 404 — nav tāfeles saite, 401 — piekļuve ar saiti izslēgta vai tāfelei ir parole.
API apraksts programmām
Mašīnlasāms API apraksts (OpenAPI 3.1), ko var importēt Postman, n8n, Make un klientu ģeneratoros: https://doshka-online.by/openapi.json
Kļūdas
Atbilde ar kodu, kas nav 2xx, satur lauku error ar kļūdas tekstu, elementu labošanā arī code (missing, locked, geometry, color, link, text). 400: nederīgs pieprasījuma ķermenis; 401: nav atslēgas vai tā ir nederīga; 404: tāfeles vai elementa nav vai jums nav piekļuves; 409: elements ir piestiprināts; 429: pārāk bieži.
Palīdzība · Instrukcijas · Jautājumi un atbildes · Pāreja no Miro · Pārcelšanās no Holst · Doshka un citas tiešsaistes tāfeles: godīgs salīdzinājums · Atbalstītās valodas · Doshka integrācijas · Doshka API izstrādātājiem · Par servisu · Lietošanas noteikumi · Privātuma politika · Kontakti · Licences · Veidnes · Pielietojums · Raksti
Citas valodas: Русский · Беларуская · Қазақша · Oʻzbekcha · Кыргызча · Тоҷикӣ · Հայերեն · Azərbaycanca · Română · Türkmençe · Lietuvių · Polski · Eesti · English