Doshka — tablă online pentru lecții, întâlniri și lucru în echipă

API Doshka pentru dezvoltatori

Un API REST și webhook-uri pentru a crea table, a le citi și a le modifica conținutul din propriile programe: notițe cu sarcini din tracker și tranzacții din CRM, diagrame din forme și săgeți, editarea și ștergerea elementelor, evenimente despre notițe și comentarii noi. Format: JSON; adresa: https://doshka-online.by/api/v1.

Cheia API

Fiecare cerere se trimite cu antetul Authorization: Bearer și cheia dvs.

Metode

Notiță: text, color și opțional x, y. Culori: yellow, green, blue, pink, orange, violet, red, teal, lime, cyan, gray, white.

Limită — 120 de cereri pe minut pentru o cheie; peste aceasta, răspunsul este 429.

Exemplu: adăugarea unei notițe

curl, Python și JavaScript — aceeași cerere.

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" }] }),
});

Diagrame: forme și săgeți

POST /api/v1/boards/ID/elements primește o listă elements. type: sticker, rectangle, ellipse, diamond, text sau arrow; text este eticheta formei sau a săgeții ori textul propriu-zis; color folosește culorile notițelor; x, y, width, height, link (doar https://). O săgeată leagă from și to: id-ul unui element de pe tablă sau ref-ul unei forme din aceeași cerere. Săgețile rămân legate: mutați forma și săgețile o urmează. Dacă o săgeată indică un element inexistent, întreaga cerere este respinsă și tabla nu se schimbă. Cu layout (right sau down), formele fără x și y se așază singure ca o schemă logică: pe straturi, după săgeți, sub conținutul tablei.

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 mută forma împreună cu eticheta și capetele săgeților. API-ul nu modifică un element fixat pe tablă (răspuns 409).

Noduri n8n

Pachetul n8n-nodes-doshka: nodul Doshka creează și redenumește table, adaugă notițe (elementele de intrare se trimit în loturi de câte 100), desenează diagrame cu așezare automată, editează și șterge elemente; nodul Doshka Trigger pornește un flux când o notiță este creată, modificată sau ștearsă, se adaugă un comentariu sau tabla se schimbă. n8n creează și șterge singur abonarea la webhook și verifică semnătura fiecărui mesaj. Credențialele Doshka API primesc cheia dvs. Pentru declanșator, n8n trebuie să fie accesibil din internet prin https.

n8n → Settings → Community nodes → Install → n8n-nodes-doshka

Server MCP pentru asistenții AI

MCP (Model Context Protocol) este standardul prin care asistenții AI lucrează cu alte servicii. Cu serverul MCP al Doshka îi puteți cere asistentului „pune sarcinile din acest e-mail ca notițe pe o tablă nouă” sau „desenează schema procesului de comandă”, iar el o face singur și vă trimite linkul tablei.

Configurare: 1) creați o cheie API (pagina principală Doshka → Chei API); 2) instalați Node.js 18 sau mai nou; 3) descărcați https://doshka-online.by/doshka-mcp.mjs: acest fișier este tot serverul, fără alte pachete; 4) adăugați-l în setările asistentului ca în exemplul de mai jos (Claude Desktop: Settings → Developer → Edit Config; Cursor: fișierul .cursor/mcp.json), cu cheia dvs. în loc de dk_... și calea unde ați salvat fișierul. Verificare: node doshka-mcp.mjs --check.

{
  "mcpServers": {
    "doshka": {
      "command": "node",
      "args": ["C:\\Users\\me\\Downloads\\doshka-mcp.mjs"],
      "env": { "DOSHKA_API_KEY": "dk_..." }
    }
  }
}

Sau fără descărcarea fișierului — din npm (pachetul doshka-mcp), Node.js îl descarcă singur:

{
  "mcpServers": {
    "doshka": {
      "command": "npx",
      "args": ["-y", "doshka-mcp"],
      "env": { "DOSHKA_API_KEY": "dk_..." }
    }
  }
}

Claude Code, într-o singură comandă:

claude mcp add doshka -e DOSHKA_API_KEY=dk_... -- npx -y doshka-mcp

Instrumente: list_boards, create_board, get_board, rename_board, add_stickers, draw_diagram (formele fără coordonate se așază singure după săgeți), update_element, delete_element. Serverul rulează pe computerul dvs. și comunică doar cu API-ul Doshka, cu cheia dvs.: Doshka nu trimite conținutul tablelor către servicii AI; asistentul ales de dvs. face asta la cererea dvs.

Webhook-uri

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

Verificarea semnăturii (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);
}

Încorporare și oEmbed

Codul iframe se află în «Partajează» → «Încorporează pe site». Tabla încorporată este doar pentru vizualizare și se actualizează în timp real.

oEmbed: GET /oembed?url= și linkul «Doar vizualizare» al tablei. Răspunsul este type rich cu codul iframe. Erori: 404 — nu este un link de tablă, 401 — accesul prin link este dezactivat sau tabla are parolă.

Descrierea API pentru programe

Descrierea API citibilă de mașini (OpenAPI 3.1), care se poate importa în Postman, n8n, Make și generatoare de clienți: https://doshka-online.by/openapi.json

Erori

Un răspuns cu cod diferit de 2xx conține câmpul error cu textul erorii; la editarea elementelor, și code (missing, locked, geometry, color, link, text). 400: corp de cerere invalid; 401: cheie lipsă sau invalidă; 404: tabla sau elementul nu există sau nu aveți acces; 409: elementul este fixat; 429: prea multe cereri.

Ajutor · Instrucțiuni · Întrebări și răspunsuri · Mutarea de pe Miro · Mutarea din Holst · Doshka și alte table online: o comparație onestă · Limbi acceptate · Integrările Doshka · API Doshka pentru dezvoltatori · Despre serviciu · Acordul de utilizare · Politica de confidențialitate · Contacte · Licențe · Șabloane · Pentru cine · Articole

Alte limbi: Русский · Беларуская · Қазақша · Oʻzbekcha · Кыргызча · Тоҷикӣ · Հայերեն · Azərbaycanca · Türkmençe · Latviešu · Lietuvių · Polski · Eesti · English