Doshka — darslar, uchrashuvlar va jamoaviy ish uchun onlayn doska
Dasturchilar uchun Doshka API
Oʻz dasturlaringizdan doska yaratish, uning tarkibini oʻqish va oʻzgartirish uchun REST API va vebxuklar: trekerdagi vazifalar va CRM dagi bitimlar stiker koʻrinishida, shakl va strelkalardan sxemalar, elementlarni tahrirlash va oʻchirish, yangi stikerlar va izohlar haqida hodisalar. Format — JSON, manzil — https://doshka-online.by/api/v1.
API kaliti
- Doshkaga kiring va bosh sahifada «API kalitlari» → «Kalit yaratish» tugmasini bosing.
- Kalit (dk_ bilan boshlanadi) bir marta koʻrsatiladi — uni parol kabi saqlang.
- Kalit egasining huquqlari bilan bir xil huquq beradi: shaxsiy doskalar va uning tashkilotlari doskalari.
- Oshkor boʻlgan yoki keraksiz kalitni shu yerda oʻchiring — u bilan soʻrovlar darhol oʻtmay qoladi.
Har bir soʻrov Authorization: Bearer sarlavhasi va kalitingiz bilan yuboriladi.
Usullar
- GET /api/v1/me — kalit egasi: id, pochta, ism.
- GET /api/v1/boards — doskalar: id, nom, tashkilot, yaratilgan sana.
- POST /api/v1/boards — doska yaratish; tanada title va orgId berish mumkin.
- GET /api/v1/boards/ID — doska va uning elementlari: turi, koordinatalari, oʻlchami, matni, stiker rangi.
- PATCH /api/v1/boards/ID — doska nomini oʻzgartirish: tanasida title.
- POST /api/v1/boards/ID/stickers — stikerlar qoʻshish, bir martada 100 tagacha; x va y boʻlmasa, ular doskadagi hamma narsa ostida qator-qator joylashadi.
- POST /api/v1/boards/ID/elements — shakllar, yozuvlar va strelkalar chizish, bir martada 200 tagacha — batafsil «Sxemalar» boʻlimida.
- PATCH /api/v1/boards/ID/elements/ID — elementni oʻzgartirish: text, color, x, y, width, height, link — faqat oʻzgaradiganini yuboring.
- DELETE /api/v1/boards/ID/elements/ID — elementni yozuvi bilan birga oʻchirish; bogʻlangan strelkalar qoladi, lekin uziladi.
- GET /api/v1/webhooks — vebxuklaringiz va ularning holati.
- POST /api/v1/webhooks — doska hodisalariga obuna boʻlish: boardId, serveringizning https://… manzili va events roʻyxati; javobda imzoni tekshirish uchun maxfiy kalit bor (bir marta koʻrsatiladi).
- DELETE /api/v1/webhooks/ID — obunani bekor qilish.
Stiker: text, color va xohishga koʻra x, y. Ranglar: yellow, green, blue, pink, orange, violet, red, teal, lime, cyan, gray, white.
Cheklov — bir kalitga daqiqasiga 120 soʻrov, oshib ketsa — 429 javobi.
Misol: stiker qoʻshish
curl, Python va JavaScript — bitta soʻrov.
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" }] }),
});
Sxemalar: shakllar va strelkalar
POST /api/v1/boards/ID/elements elements roʻyxatini qabul qiladi. type: sticker, rectangle, ellipse, diamond, text yoki arrow; text — shakl, strelka yozuvi yoki yozuvning oʻzi; color — stikerlardagi ranglar; x, y, width, height, link (faqat https://). Strelka from va to ni bogʻlaydi — doskadagi element id si yoki shu soʻrovdagi shaklning ref i. Strelkalar bogʻlangan: shaklni surishsa, strelka ortidan boradi. Agar strelka mavjud boʻlmagan elementga ishora qilsa, soʻrov butunlay rad etiladi va doska oʻzgarmaydi. layout maydoni bilan (right yoki down) x va y siz shakllar blok-sxema kabi oʻzi joylashadi: doska tarkibi ostida strelkalar boʻyicha qatlam-qatlam.
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 orqali tahrir shaklni yozuvi va strelkalar uchlari bilan birga suradi. Doskada mahkamlangan elementni API oʻzgartirmaydi (javob 409).
n8n tugunlari
n8n-nodes-doshka paketi: «Doshka» tuguni doska yaratadi va nomini oʻzgartiradi, stiker qoʻshadi (kirish elementlari 100 tadan yuboriladi), avtomatik joylashadigan sxema chizadi, elementlarni tahrirlaydi va oʻchiradi; «Doshka Trigger» tuguni stiker yaratilganda, oʻzgarganda yoki oʻchirilganda, izoh qoʻshilganda yoki doska oʻzgarganda jarayonni ishga tushiradi — vebxukka obunani n8n oʻzi yaratadi va oʻchiradi hamda har bir xabar imzosini tekshiradi. Doshka API hisob maʼlumotlari — kalitingiz. Trigger uchun n8n manzili internetdan https orqali ochiq boʻlishi kerak.
n8n → Settings → Community nodes → Install → n8n-nodes-doshka
SI yordamchilari uchun MCP-server
MCP (Model Context Protocol) — SI yordamchilari tashqi xizmatlar bilan ishlaydigan standart. Doshka MCP-serveri bilan yordamchidan «bu xatdagi vazifalarni yangi doskaga stikerlar qilib joyla» yoki «buyurtma jarayoni sxemasini chiz» deb soʻrash mumkin — u buni oʻzi bajaradi va doska havolasini yuboradi.
Qanday ulash: 1) API kalitini yarating (Doshka bosh sahifasi → «API kalitlari»); 2) Node.js 18 yoki yangirogʻini oʻrnating; 3) https://doshka-online.by/doshka-mcp.mjs faylini yuklab oling — bu butun server, boshqa paketlarsiz; 4) uni quyidagi misoldagidek yordamchi sozlamalariga qoʻshing (Claude Desktop: «Settings» → «Developer» → «Edit Config»; Cursor: .cursor/mcp.json fayli), dk_... oʻrniga — kalitingiz, yoʻl — fayl turgan joy. Tekshirish: node doshka-mcp.mjs --check.
{
"mcpServers": {
"doshka": {
"command": "node",
"args": ["C:\\Users\\me\\Downloads\\doshka-mcp.mjs"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Yoki faylni yuklamasdan — npm orqali (doshka-mcp paketi), Node.js uni o‘zi yuklab oladi:
{
"mcpServers": {
"doshka": {
"command": "npx",
"args": ["-y", "doshka-mcp"],
"env": { "DOSHKA_API_KEY": "dk_..." }
}
}
}Claude Code — bitta buyruq bilan:
claude mcp add doshka -e DOSHKA_API_KEY=dk_... -- npx -y doshka-mcpVositalar: list_boards, create_board, get_board, rename_board, add_stickers, draw_diagram (koordinatasiz shakllar strelkalar boʻyicha oʻzi joylashadi), update_element, delete_element. Server kompyuteringizda ishlaydi va faqat kalitingiz bilan Doshka API ga murojaat qiladi: Doshka doskalar tarkibini neyrotarmoqlarga yubormaydi, buni siz tanlagan yordamchi soʻrovingiz bilan qiladi.
Vebxuklar
- Hodisalar: board.changed — xulosa: nechta element qoʻshildi, oʻzgardi va oʻchirildi, nechta izoh va kim tahrirladi; sticker.created, sticker.updated, sticker.deleted — stikerlarning oʻzi: id, matn, rang, joy, havola; comment.added — izoh matni va u qoldirilgan element. events boʻlmasa, faqat board.changed keladi.
- 5 soniya ichidagi oʻzgarishlar yigʻiladi: har bir hodisaga — bitta POST, items ichida 100 tagacha yozuv, X-Doshka-Event sarlavhasida — hodisa nomi. Bu bilan n8n, Make va Zapier da triggerlar qurish qulay: «yangi stiker → trekerda vazifa», «izoh → chatga xabar».
- X-Doshka-Signature sarlavhasida sha256= va obuna maxfiy kaliti bilan hisoblangan soʻrov tanasining HMAC-SHA256 qiymati bor — soʻrovga ishonishdan oldin uni tekshiring.
- Manzil — faqat 443-portdagi https, ichki tarmoqda emas, qayta yoʻnaltirishsiz; javobni 5 soniya kutamiz. Ketma-ket 20 ta muvaffaqiyatsizlikdan soʻng obuna oʻchiriladi. Bitta hisobga 20 tadan koʻp boʻlmagan vebxuk.
{
"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 }]
}Imzoni tekshirish (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);
}
Joylash va oEmbed
iframe kodi — «Ulashish» → «Saytga joylash» boʻlimida. Joylangan doska faqat koʻrish uchun va jonli yangilanadi.
oEmbed: GET /oembed?url= va «Faqat koʻrish» doska havolasi. Javob — iframe kodi bilan type rich. Xatolar: 404 — doska havolasi emas, 401 — havola orqali kirish oʻchirilgan yoki doskada parol bor.
Dasturlar uchun API tavsifi
API’ning mashina oʻqiy oladigan tavsifi (OpenAPI 3.1) — uni Postman, n8n, Make va mijoz generatorlariga import qilish mumkin: https://doshka-online.by/openapi.json
Xatolar
Kodi 2xx boʻlmagan javobda xato matni bilan error maydoni boʻladi, elementlarni tahrirlashda — yana code (missing, locked, geometry, color, link, text). 400 — soʻrov tanasi notoʻgʻri, 401 — kalit yoʻq yoki notoʻgʻri, 404 — doska yoki element yoʻq yoki ularga huquq yoʻq, 409 — element mahkamlangan, 429 — juda tez-tez.
Yordam · Yo‘riqnomalar · Savollar va javoblar · Miro dan koʻchib oʻtish · Holst’dan ko‘chish · Doshka va boshqa onlayn-doskalar: halol taqqoslash · Qoʻllab-quvvatlanadigan tillar · Doshka integratsiyalari · Dasturchilar uchun Doshka API · Xizmat haqida · Foydalanuvchi kelishuvi · Maxfiylik siyosati · Aloqa · Litsenziyalar · Shablonlar · Kim uchun · Maqolalar
Boshqa tillar: Русский · Беларуская · Қазақша · Кыргызча · Тоҷикӣ · Հայերեն · Azərbaycanca · Română · Türkmençe · Latviešu · Lietuvių · Polski · Eesti · English