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

Saatke iga päring päisega Authorization: Bearer ja oma võtmega.

Meetodid

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

Töö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

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