API yoki sun'iy intellekt yordamchisi yordamida doskalarni boshqaring

Doskalar boshqaruv panelidan tashqarida to'liq boshqarilishi mumkin. Ikki yo'nalish, bitta ruxsatlar modeli va ekranlar bilan bir xil xatti-harakat — chunki ular bir xil kodni chaqiradi.

REST API

Har bir operatsiya bizning ochiq OpenAPI spetsifikatsiyamizda keltirilgan bo'lib, TypeScript, Python, PHP va Go tillari uchun yaratilgan mijozlarga ega hamda CLI ham xuddi shu spetsifikatsiyadan yaratilgan. Doskalar, ustunlar, kartochkalar, izohlar, savollar, yorliqlar, a'zolar va ulashish havolalari — barchasi qamrab olingan.

Siz eng ko'p ishlatadigan yakuniy nuqtalar (endpoints):

• GET /v1/agency/boards — sizning doskalaringiz
• GET /v1/agency/boards/{id} — ustunlari va kartochkalari bilan bitta doska
• POST /v1/agency/boards/{id}/cards — ish 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 oxirgi so'rovda va faqat o'sha so'rovda qaytariladi. Biz uning barmoq izini saqlaymiz, shuning uchun uni qayta o'qiy oladigan hech qanday yakuniy nuqta yo'q — agar skriptingizga havola kerak bo'lsa, uni javobdan saqlab qoling.

MCP serveri

Agar MCP protokolini qo'llab-quvvatlaydigan sun'iy intellekt yordamchisidan foydalansangiz, uni ulang va u to'g'ridan-to'g'ri doska vositalariga ega bo'ladi: doskalarni ro'yxatga olish, bittasini to'liq o'qish, doska yaratish, kartochka qo'shish, kartochkani ko'chirish, izoh qoldirish, ulashish havolasini yaratish va uni bekor qilish. Bu "shu haftani jamlang va Acme'ga havola yuboring" degan buyruqni ikkita tizim va nusxalash-joylashtirish o'rniga bitta ko'rsatmaga aylantiradi.

Vositalar haqida bilishga arziydigan ikkita narsa:

• Agar boshqacha ko'rsatmasangiz, yangi kartochka ichki hisoblanadi. Ichki ishingizni umumlashtirayotgan yordamchi bu xulosani mijozingizga e'lon qilmasligi kerak, chunki hech kim buni taqiqlamagan, shuning uchun visibility parametrlari sukut bo'yicha ichki qilib belgilanadi va ataylab client (mijoz) qilib o'rnatilishi shart.
• Havolani bekor qilish tasdiqlashni talab qiladi, chunki u o'sha havola orqali qo'shilgan har qanday shaxsni ham o'chirib tashlaydi — va vosita muvaffaqiyatli bajarilgani haqida quruq xabar berish o'rniga, bu qancha odamga ta'sir qilishini ko'rsatadi.

Unga nima kerak

API va MCP trafigidan foydalanish imkoniyati Boards Business va har bir Agency xosting rejasiga kiritilgan. Boards Free va Boards Pro rejalarida doska so'rovlari bu haqda xabar beruvchi javob qaytaradi.

API kaliti yoki MCP ulanishi faqat uni yaratgan shaxs bajara oladigan ishlarni va o'zi ruxsat etilgan tashkilotlardagina bajarishi mumkin. Yordamchi tomonidan yaratilgan ulashish havolasi ham xuddi shunday cheklangan: u avtorizatsiya qilayotgan shaxsning o'zida mavjud bo'lmagan rolni bera olmaydi.