Doshka — tablica online do zajęć, spotkań i pracy zespołowej
API Doshki dla programistów
REST API i webhooki do tworzenia tablic oraz odczytu i zmiany ich zawartości z własnych programów: karteczki z zadaniami z trackera i transakcjami z CRM, diagramy z kształtów i strzałek, edycja i usuwanie elementów, zdarzenia o nowych karteczkach i komentarzach. Format: JSON; adres: https://doshka-online.by/api/v1.
Klucz API
- Zaloguj się do Doshki i na stronie głównej kliknij «Klucze API» → «Utwórz klucz».
- Klucz (zaczyna się od dk_) jest pokazywany tylko raz — przechowuj go jak hasło.
- Klucz ma te same uprawnienia co jego właściciel: tablice osobiste i tablice jego organizacji.
- Wyciekły lub niepotrzebny klucz usuń w tym samym miejscu — żądania z nim od razu przestaną przechodzić.
Każde żądanie wysyłaj z nagłówkiem Authorization: Bearer i swoim kluczem.
Metody
- GET /api/v1/me — właściciel klucza: id, e-mail, imię.
- GET /api/v1/boards — tablice: id, nazwa, organizacja, data utworzenia.
- POST /api/v1/boards — utwórz tablicę; w treści można przekazać title i orgId.
- GET /api/v1/boards/ID — tablica i jej elementy: typ, współrzędne, rozmiar, tekst, kolor karteczki.
- PATCH /api/v1/boards/ID — zmiana nazwy tablicy: title w treści żądania.
- POST /api/v1/boards/ID/stickers — dodaj karteczki, do 100 naraz; bez x i y ustawią się w rzędach pod wszystkim, co jest już na tablicy.
- POST /api/v1/boards/ID/elements — rysowanie kształtów, napisów i strzałek, do 200 naraz; szczegóły w sekcji „Diagramy”.
- PATCH /api/v1/boards/ID/elements/ID — zmiana elementu: text, color, x, y, width, height, link; wyślij tylko to, co się zmienia.
- DELETE /api/v1/boards/ID/elements/ID — usunięcie elementu razem z jego podpisem; połączone strzałki zostają, ale są odłączane.
- GET /api/v1/webhooks — Twoje webhooki i ich stan.
- POST /api/v1/webhooks — subskrypcja zdarzeń tablicy: boardId, adres https://… Twojego serwera i lista events; w odpowiedzi jest sekret do weryfikacji podpisu (pokazywany raz).
- DELETE /api/v1/webhooks/ID — anuluj subskrypcję.
Karteczka: text, color i opcjonalnie x, y. Kolory: yellow, green, blue, pink, orange, violet, red, teal, lime, cyan, gray, white.
Limit — 120 żądań na minutę na klucz; po przekroczeniu odpowiedź 429.
Przykład: dodaj karteczkę
curl, Python i JavaScript — to samo żądanie.
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" }] }),
});
Diagramy: kształty i strzałki
POST /api/v1/boards/ID/elements przyjmuje listę elements. type: sticker, rectangle, ellipse, diamond, text lub arrow; text to podpis kształtu lub strzałki albo sam napis; color to te same kolory co karteczek; x, y, width, height, link (tylko https://). Strzałka łączy from i to: id elementu na tablicy lub ref kształtu z tego samego żądania. Strzałki pozostają połączone: przesuń kształt, a strzałka podąży za nim. Jeśli strzałka wskazuje nieistniejący element, całe żądanie jest odrzucane, a tablica się nie zmienia. Z polem layout (right lub down) kształty bez x i y układają się same jak schemat blokowy: warstwami według strzałek, pod zawartością tablicy.
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"}
]}'Edycja przez PATCH przesuwa kształt razem z podpisem i końcami strzałek. API nie zmienia elementu przypiętego na tablicy (odpowiedź 409).
Węzły n8n
Pakiet n8n-nodes-doshka: węzeł Doshka tworzy tablice i zmienia ich nazwy, dodaje karteczki (elementy wejściowe wysyłane są paczkami po 100), rysuje diagramy z automatycznym układem, edytuje i usuwa elementy; węzeł Doshka Trigger uruchamia przepływ, gdy karteczka zostanie utworzona, zmieniona lub usunięta, dodany zostanie komentarz lub tablica się zmieni. n8n sam tworzy i usuwa subskrypcję webhooka i sprawdza podpis każdej wiadomości. W poświadczeniach Doshka API podaj swój klucz. Dla wyzwalacza n8n musi być dostępny z internetu przez https.
n8n → Settings → Community nodes → Install → n8n-nodes-doshka
Serwer MCP dla asystentów AI
MCP (Model Context Protocol) to standard, dzięki któremu asystenci AI pracują z innymi usługami. Z serwerem MCP Doshki możesz poprosić asystenta: „rozłóż zadania z tego maila na karteczki na nowej tablicy” albo „narysuj schemat procesu zamówienia”, a on zrobi to sam i przyśle link do tablicy.
Jak podłączyć: 1) utwórz klucz API (strona główna Doshki → Klucze API); 2) zainstaluj Node.js 18 lub nowszy; 3) pobierz https://doshka-online.by/doshka-mcp.mjs — ten jeden plik to cały serwer, bez innych pakietów; 4) dodaj go w ustawieniach asystenta jak w przykładzie poniżej (Claude Desktop: Settings → Developer → Edit Config; Cursor: plik .cursor/mcp.json), zamiast dk_... wpisz swój klucz, a ścieżkę — tam, gdzie zapisałeś plik. Sprawdzenie: node doshka-mcp.mjs --check.
{
"mcpServers": {
"doshka": {
"command": "node",
"args": ["C:\\Users\\me\\Downloads\\doshka-mcp.mjs"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Albo bez pobierania pliku — z npm (pakiet doshka-mcp), Node.js pobierze go sam:
{
"mcpServers": {
"doshka": {
"command": "npx",
"args": ["-y", "doshka-mcp"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Claude Code — jednym poleceniem:
claude mcp add doshka -e DOSHKA_API_KEY=dk_... -- npx -y doshka-mcpNarzędzia: list_boards, create_board, get_board, rename_board, add_stickers, draw_diagram (kształty bez współrzędnych układają się same według strzałek), update_element, delete_element. Serwer działa na Twoim komputerze i łączy się tylko z API Doshki Twoim kluczem: Doshka nie wysyła zawartości tablic do usług AI — robi to wybrany przez Ciebie asystent na Twoją prośbę.
Webhooki
- Zdarzenia: board.changed to podsumowanie: ile elementów dodano, zmieniono i usunięto, ile komentarzy i kto edytował; sticker.created, sticker.updated, sticker.deleted zawierają same karteczki: id, tekst, kolor, położenie, link; comment.added zawiera tekst komentarza i element, przy którym go zostawiono. Bez events wysyłane jest tylko board.changed.
- Zmiany z 5 sekund są grupowane: jeden POST na zdarzenie, do 100 wpisów w items, a nagłówek X-Doshka-Event zawiera nazwę zdarzenia. Dzięki temu łatwo budować wyzwalacze w n8n, Make i Zapier: „nowa karteczka → zadanie w trackerze”, „komentarz → wiadomość na czacie”.
- Nagłówek X-Doshka-Signature zawiera sha256= i HMAC-SHA256 treści żądania z sekretem subskrypcji — sprawdź go, zanim zaufasz żądaniu.
- Adres — tylko https na porcie 443, poza siecią wewnętrzną, bez przekierowań; na odpowiedź czekamy 5 sekund. Po 20 nieudanych próbach z rzędu subskrypcja jest wyłączana. Nie więcej niż 20 webhooków na konto.
{
"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 }]
}Weryfikacja podpisu (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);
}
Osadzanie i oEmbed
Kod iframe znajdziesz w «Udostępnij» → «Osadź na stronie». Osadzona tablica jest tylko do podglądu i aktualizuje się na żywo.
oEmbed: GET /oembed?url= i link do tablicy «Tylko podgląd». Odpowiedź — type rich z kodem iframe. Błędy: 404 — to nie link do tablicy, 401 — dostęp przez link jest wyłączony lub tablica ma hasło.
Opis API dla programów
Opis API czytelny dla maszyn (OpenAPI 3.1), który można zaimportować do Postman, n8n, Make i generatorów klientów: https://doshka-online.by/openapi.json
Błędy
Odpowiedź z kodem innym niż 2xx zawiera pole error z treścią błędu, a przy edycji elementów także code (missing, locked, geometry, color, link, text). 400: nieprawidłowa treść żądania; 401: brak klucza lub nieprawidłowy klucz; 404: tablica lub element nie istnieje albo nie masz dostępu; 409: element jest przypięty; 429: zbyt wiele żądań.
Pomoc · Instrukcje · Pytania i odpowiedzi · Przejście z Miro · Przeprowadzka z Holst · Doshka i inne tablice online: uczciwe porównanie · Obsługiwane języki · Integracje Doshki · API Doshki dla programistów · O serwisie · Regulamin · Polityka prywatności · Kontakt · Licencje · Szablony · Zastosowania · Artykuły
Inne języki: Русский · Беларуская · Қазақша · Oʻzbekcha · Кыргызча · Тоҷикӣ · Հայերեն · Azərbaycanca · Română · Türkmençe · Latviešu · Lietuvių · Eesti · English