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ı
- Doshkaya daxil olun və əsas səhifədə «API açarları» → «Açar yarat» düyməsini basın.
- Açar (dk_ ilə başlayır) bir dəfə göstərilir — onu parol kimi saxlayın.
- Açar sahibinin hüquqları ilə eyni hüquq verir: şəxsi lövhələr və onun təşkilatlarının lövhələri.
- Sızmış və ya lazımsız açarı elə orada silin — onunla sorğular dərhal keçməyəcək.
Hər sorğu Authorization: Bearer başlığı və açarınızla göndərilir.
Metodlar
- GET /api/v1/me — açarın sahibi: id, poçt, ad.
- GET /api/v1/boards — lövhələr: id, ad, təşkilat, yaradılma tarixi.
- POST /api/v1/boards — lövhə yaratmaq; gövdədə title və orgId vermək olar.
- GET /api/v1/boards/ID — lövhə və onun elementləri: növ, koordinatlar, ölçü, mətn, stikerin rəngi.
- PATCH /api/v1/boards/ID — lövhənin adını dəyişmək: gövdədə title.
- POST /api/v1/boards/ID/stickers — stikerlər əlavə etmək, bir dəfəyə 100-ə qədər; x və y olmadan onlar lövhədəki hər şeyin altında sıra ilə düzülür.
- POST /api/v1/boards/ID/elements — fiqurlar, yazılar və oxlar çəkmək, bir dəfəyə 200-ə qədər — ətraflı «Sxemlər» bölməsində.
- PATCH /api/v1/boards/ID/elements/ID — elementi dəyişmək: text, color, x, y, width, height, link — yalnız dəyişəni göndərin.
- DELETE /api/v1/boards/ID/elements/ID — elementi yazısı ilə birlikdə silmək; bağlı oxlar qalır, amma ayrılır.
- GET /api/v1/webhooks — vebhuklarınız və onların vəziyyəti.
- POST /api/v1/webhooks — lövhənin hadisələrinə abunə olmaq: boardId, serverinizin https://… ünvanı və events siyahısı; cavabda imzanı yoxlamaq üçün gizli açar var (bir dəfə göstərilir).
- DELETE /api/v1/webhooks/ID — abunəni ləğv etmək.
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-mcpAlə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
- Hadisələr: board.changed — xülasə: neçə element əlavə edildi, dəyişdirildi və silindi, neçə şərh və kim redaktə etdi; sticker.created, sticker.updated, sticker.deleted — stikerlərin özü: id, mətn, rəng, yer, keçid; comment.added — şərhin mətni və onun qoyulduğu element. events olmadan yalnız board.changed gəlir.
- 5 saniyədəki dəyişikliklər toplanır: hər hadisəyə — bir POST, items-də 100-ə qədər qeyd, X-Doshka-Event başlığında — hadisənin adı. Bununla n8n, Make və Zapier-də triggerlər qurmaq rahatdır: «yeni stiker → trekerdə tapşırıq», «şərh → çata mesaj».
- X-Doshka-Signature başlığında sha256= və abunəliyin gizli açarı ilə sorğu gövdəsinin HMAC-SHA256 dəyəri var — sorğuya etibar etməzdən əvvəl onu yoxlayın.
- Ünvan — yalnız 443 portunda https, daxili şəbəkədə deyil, yönləndirmə olmadan; cavabı 5 saniyə gözləyirik. Ardıcıl 20 uğursuzluqdan sonra abunəlik söndürülür. Bir hesaba 20-dən çox olmayan vebhuk.
{
"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