Doshka — dərslər, görüşlər və komanda işi üçün onlayn lövhə

Proqramçılar üçün Doshka API

Öz proqramlarınızdan lövhə yaratmaq, onların məzmununu oxumaq və dəyişmək üçün REST API və vebhuklar: trekerdəki tapşırıqlar və CRM-dəki sövdələşmələr stiker kimi, fiqur və oxlardan sxemlər, elementlərin redaktəsi və silinməsi, yeni stikerlər və şərhlər haqqında hadisələr. Format — JSON, ünvan — https://doshka-online.by/api/v1.

API açarı

Hər sorğu Authorization: Bearer başlığı və açarınızla göndərilir.

Metodlar

Stiker: text, color və istəyə görə x, y. Rənglər: yellow, green, blue, pink, orange, violet, red, teal, lime, cyan, gray, white.

Məhdudiyyət — bir açara dəqiqədə 120 sorğu, artıq olduqda — 429 cavabı.

Nümunə: stiker əlavə etmək

curl, Python və JavaScript — eyni sorğu.

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

Sxemlər: fiqurlar və oxlar

POST /api/v1/boards/ID/elements elements siyahısını qəbul edir. type: sticker, rectangle, ellipse, diamond, text və ya arrow; text — fiqurun, oxun yazısı və ya yazının özü; color — stikerlərin rəngləri; x, y, width, height, link (yalnız https://). Ox from və to-nu birləşdirir — lövhədəki elementin id-si və ya həmin sorğudakı fiqurun ref-i. Oxlar bağlıdır: fiquru tərpədəndə ox onun ardınca gedir. Ox mövcud olmayan elementə işarə edirsə, sorğu tamamilə rədd edilir və lövhə dəyişmir. layout sahəsi ilə (right və ya down) x və y olmayan fiqurlar blok-sxem kimi özü düzülür: lövhənin məzmununun altında oxlar üzrə qat-qat.

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 ilə redaktə fiquru yazısı və oxların ucları ilə birlikdə yerindən oynadır. Lövhədə bərkidilmiş elementi API dəyişmir (cavab 409).

n8n düyünləri

n8n-nodes-doshka paketi: «Doshka» düyünü lövhə yaradır və adını dəyişir, stiker əlavə edir (giriş elementləri 100-lük paketlərlə göndərilir), avtomatik düzülən sxemlər çəkir, elementləri redaktə edir və silir; «Doshka Trigger» düyünü stiker yaradılanda, dəyişdiriləndə və ya silinəndə, şərh əlavə ediləndə və ya lövhə dəyişəndə prosesi işə salır — vebhuka abunəni n8n özü yaradır və silir, hər mesajın imzasını yoxlayır. Doshka API hesab məlumatları — açarınız. Trigger üçün n8n ünvanı internetdən https ilə əlçatan olmalıdır.

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

Sİ köməkçiləri üçün MCP-server

MCP (Model Context Protocol) — Sİ köməkçilərinin xarici xidmətlərlə işlədiyi standartdır. Doshka MCP-serveri ilə köməkçidən «bu məktubdakı tapşırıqları yeni lövhədə stiker kimi düz» və ya «sifariş prosesinin sxemini çək» deyə xahiş etmək olar — o bunu özü edib lövhənin keçidini göndərəcək.

Necə qoşmaq: 1) API açarı yaradın (Doshka-nın ana səhifəsi → «API açarları»); 2) Node.js 18 və ya daha yenisini quraşdırın; 3) https://doshka-online.by/doshka-mcp.mjs faylını endirin — bu, bütün serverdir, başqa paketsiz; 4) onu aşağıdakı nümunədəki kimi köməkçinin ayarlarına əlavə edin (Claude Desktop: «Settings» → «Developer» → «Edit Config»; Cursor: .cursor/mcp.json faylı), dk_... əvəzinə — açarınız, yol — faylın olduğu yer. Yoxlama: node doshka-mcp.mjs --check.

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

Və ya faylı yükləmədən — npm vasitəsilə (doshka-mcp paketi), Node.js onu özü yükləyir:

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

Claude Code — bir əmrlə:

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

Alətlər: list_boards, create_board, get_board, rename_board, add_stickers, draw_diagram (koordinatsız fiqurlar oxlar üzrə özü düzülür), update_element, delete_element. Server kompüterinizdə işləyir və yalnız açarınızla Doshka API-yə müraciət edir: Doshka lövhələrin məzmununu neyroşəbəkələrə göndərmir, bunu seçdiyiniz köməkçi xahişinizlə edir.

Vebhuklar

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

İmzanın yoxlanması (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);
}

Yerləşdirmə və oEmbed

iframe kodu — «Paylaş» → «Sayta yerləşdir» bölməsindədir. Yerləşdirilmiş lövhə yalnız baxış üçündür və canlı yenilənir.

oEmbed: GET /oembed?url= və «Yalnız baxış» lövhə linki. Cavab — iframe kodu ilə type rich. Xətalar: 404 — lövhə linki deyil, 401 — link ilə giriş söndürülüb və ya lövhədə parol var.

Proqramlar üçün API təsviri

API-nin maşın tərəfindən oxunan təsviri (OpenAPI 3.1) — onu Postman, n8n, Make və müştəri generatorlarına idxal etmək olar: https://doshka-online.by/openapi.json

Xətalar

Kodu 2xx olmayan cavabda xətanın mətni ilə error sahəsi olur, elementlərin redaktəsində — həm də code (missing, locked, geometry, color, link, text). 400 — sorğunun gövdəsi yanlışdır, 401 — açar yoxdur və ya yanlışdır, 404 — lövhə və ya element yoxdur, ya da onlara hüquq yoxdur, 409 — element bərkidilib, 429 — həddən artıq tez-tez.

Kömək · Təlimatlar · Suallar və cavablar · Miro-dan köçmə · Holst-dan köçmə · Doshka və digər onlayn lövhələr: dürüst müqayisə · Dəstəklənən dillər · Doshka inteqrasiyaları · Proqramçılar üçün Doshka API · Xidmət haqqında · İstifadəçi razılaşması · Məxfilik siyasəti · Əlaqə · Lisenziyalar · Şablonlar · Kim üçün · Məqalələr

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