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

Kiekvieną užklausą siųskite su antrašte Authorization: Bearer ir savo raktu.

Metodai

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

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