Doskalarni toʻliq boshqaruv panelidan tashqarida boshqarish mumkin. Ikkita marshrut, bitta ruxsatlar modeli va ekranlar bilan bir xil xatti-harakat — chunki ular bir xil kodni chaqiradi.
The REST API
Har bir operatsiya bizning ochiq OpenAPI spetsifikatsiyamizda mavjud boʻlib, TypeScript, Python, PHP va Go tillarida yaratilgan mijozlar bilan taʼminlangan hamda CLI ham xuddi shu spetsifikatsiya asosida yaratilgan. Doskalar, ustunlar, kartalar, izohlar, savollar, teglar, aʼzolar va ulashish havolalari — barchasi qamrab olingan.
Siz eng koʻp foydalanadigan oxirgi nuqtalar (endpoints):
GET /v1/agency/boards — sizning doskalaringiz
GET /v1/agency/boards/{id} — ustunlari va kartalari bilan bitta doska
POST /v1/agency/boards/{id}/cards — vazifa qoʻshish
POST /v1/agency/boards/{id}/cards/{id}/move — uni koʻchirish
POST /v1/agency/boards/{id}/invites — ulashish havolasini yaratish
Ulashish havolasining tokeni aynan shu oxirgi chaqiruvda va faqat shu chaqiruvda qaytariladi. Biz uning raqamli izini saqlaymiz, shuning uchun uni qayta oʻqiy oladigan hech qanday oxirgi nuqta yoʻq — agar skriptingizga havola kerak boʻlsa, uni javobdan saqlab qoling.
The MCP server
Agar siz MCP bilan ishlaydigan sunʼiy intellekt yordamchisidan foydalansangiz, uni ulang va u bevosita doska vositalariga ega boʻladi: doskalar roʻyxatini olish, bittasini toʻliq oʻqish, doska yaratish, karta qoʻshish, kartani koʻchirish, izoh qoldirish, ulashish havolasini yaratish va uni bekor qilish. Bu "ushbu haftani xulosalang va Acmeʼga havola yuboring" degan talabni ikkita tizim va nusxalash-joylash oʻrniga bitta koʻrsatmaga aylantiradi.
Vositalar haqida bilish kerak boʻlgan ikkita narsa:
- Agar boshqacha koʻrsatmasangiz, yangi karta ichki hisoblanadi. Ichki ishingizni xulosalayotgan yordamchi hech kim taqiqlamagani uchungina ushbu xulosani mijozingizga eʼlon qilmasligi kerak, shuning uchun
visibility sukut boʻyicha ichki boʻladi va uni qasddan client ga oʻrnatish kerak.
- Havolani bekor qilish tasdiqlashni talab qiladi, chunki u ushbu havola orqali qoʻshilgan har qanday shaxsni ham olib tashlaydi — va vosita shunchaki muvaffaqiyat haqida hisobot berish oʻrniga, bu qancha odam boʻlganini aytadi.
Nima talab qilinadi
API va MCPʼdan foydalanish huquqi Boards Business va barcha Agency hosting rejalariga kiritilgan. Boards Free va Boards Pro rejalarida doska oxirgi nuqtalari bu haqda xabar beradi.
API kaliti yoki MCP ulanishi faqat uni yaratgan shaxs oʻzi bajara oladigan ishlarni, faqat ular ruxsat berilgan tashkilotlardagina amalga oshirishi mumkin. Yordamchi tomonidan yaratilgan ulashish havolasi ham xuddi shunday cheklangan: u ruxsat beruvchi insonning oʻzida mavjud boʻlmagan rolni taqdim eta olmaydi.