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

Każde żądanie wysyłaj z nagłówkiem Authorization: Bearer i swoim kluczem.

Metody

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

Narzę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

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