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

Katru pieprasījumu sūtiet ar galveni Authorization: Bearer un savu atslēgu.

Metodes

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-mcp

Rī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

{
  "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