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
- Intrați în Doshka și pe pagina principală apăsați «Chei API» → «Creează cheia».
- Cheia (începe cu dk_) este afișată o singură dată — păstrați-o ca pe o parolă.
- Cheia are aceleași drepturi ca proprietarul ei: tablele personale și tablele organizațiilor sale.
- Ștergeți în același loc o cheie compromisă sau inutilă — cererile cu ea nu mai trec imediat.
Fiecare cerere se trimite cu antetul Authorization: Bearer și cheia dvs.
Metode
- GET /api/v1/me — proprietarul cheii: id, e-mail, nume.
- GET /api/v1/boards — table: id, nume, organizație, data creării.
- POST /api/v1/boards — creează o tablă; în corp se pot transmite title și orgId.
- GET /api/v1/boards/ID — tabla și elementele ei: tip, coordonate, dimensiune, text, culoarea notiței.
- PATCH /api/v1/boards/ID — redenumirea unei table: title în corpul cererii.
- POST /api/v1/boards/ID/stickers — adaugă notițe, până la 100 deodată; fără x și y se așază pe rânduri sub tot ce este deja pe tablă.
- POST /api/v1/boards/ID/elements — desenarea de forme, texte și săgeți, până la 200 deodată; detalii în secțiunea „Diagrame”.
- PATCH /api/v1/boards/ID/elements/ID — modificarea unui element: text, color, x, y, width, height, link; trimiteți doar ce se schimbă.
- DELETE /api/v1/boards/ID/elements/ID — ștergerea unui element împreună cu eticheta; săgețile legate rămân, dar se desprind.
- GET /api/v1/webhooks — webhook-urile dvs. și starea lor.
- POST /api/v1/webhooks — abonarea la evenimentele tablei: boardId, adresa https://… a serverului dvs. și lista events; răspunsul conține secretul pentru verificarea semnăturii (afișat o singură dată).
- DELETE /api/v1/webhooks/ID — dezabonare.
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-mcpInstrumente: 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
- Evenimente: board.changed este un rezumat: câte elemente s-au adăugat, modificat și șters, câte comentarii și cine a făcut modificările; sticker.created, sticker.updated, sticker.deleted conțin notițele propriu-zise: id, text, culoare, poziție, link; comment.added conține textul comentariului și elementul la care a fost lăsat. Fără events se trimite doar board.changed.
- Modificările din 5 secunde se grupează: un POST pentru fiecare eveniment, până la 100 de înregistrări în items, iar antetul X-Doshka-Event conține numele evenimentului. Astfel se construiesc ușor declanșatoare în n8n, Make și Zapier: „notiță nouă → sarcină în tracker”, „comentariu → mesaj în chat”.
- Antetul X-Doshka-Signature conține sha256= și HMAC-SHA256 al corpului cererii cu secretul abonamentului — verificați-l înainte de a avea încredere în cerere.
- Adresa — doar https pe portul 443, nu în rețeaua internă, fără redirecționări; așteptăm răspunsul 5 secunde. După 20 de eșecuri la rând, abonamentul se dezactivează. Cel mult 20 de webhook-uri pe cont.
{
"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