Lövhələri API və ya AI köməkçisi vasitəsilə idarə edin

Lövhələr idarəetmə panelinin xaricindən tam idarə oluna bilir. İki marşrut, bir icazə modeli və interfeys ekranları ilə eyni davranış — çünki onlar eyni kodu çağırır.

REST API

Hər bir əməliyyat açıq OpenAPI spesifikasiyamızda mövcuddur; TypeScript, Python, PHP və Go dillərində generasiya edilmiş müştəri kitabxanaları təqdim olunur və CLI aləti də eyni spesifikasiyadan generasiya edilir. Lövhələr, sütunlar, kartlar, şərhlər, suallar, etiketlər, üzvlər və paylaşma keçidləri tam əhatə olunub.

Ən çox istifadə edəcəyiniz son nöqtələr:

• GET /v1/agency/boards — lövhələriniz
• GET /v1/agency/boards/{id} — sütunları və kartları ilə birlikdə bir lövhə
• POST /v1/agency/boards/{id}/cards — iş əlavə etmək
• POST /v1/agency/boards/{id}/cards/{id}/move — onu köçürmək
• POST /v1/agency/boards/{id}/invites — paylaşma keçidi yaratmaq

Paylaşma keçidinin tokeni məhz həmin son çağırışda və yalnız həmin çağırışda qaytarılır. Biz onun rəqəmsal izini saxlayırıq, buna görə də onu təkrar oxuya bilən heç bir son nöqtə yoxdur — əgər skriptinizə keçid lazımdırsa, onu cavabdan yaddaşda saxlayın.

MCP serveri

MCP protokolunu dəstəkləyən AI köməkçisindən istifadə edirsinizsə, onu qoşun və o, birbaşa lövhə alətlərini əldə etsin: lövhələri sadalamaq, birini tam oxumaq, lövhə yaratmaq, kart əlavə etmək, kartı köçürmək, şərh yazmaq, paylaşma keçidi yaratmaq və onu ləğv etmək. Bu, "bu həftəni xülasə et və Acme şirkətinə keçid göndər" tələbini iki fərqli sistem və kopyalayıb-yapışdırmaq əvəzinə tək bir təlimata çevirir.

Alətlər haqqında bilməli olduğunuz iki vacib məqam:

• Siz başqa cür təyin etmədikcə, yeni kart daxili hesab olunur. Daxili işlərinizi xülasə edən köməkçi heç kim etiraz etməyib deyə həmin xülasəni müştərinizə təqdim etməməlidir, buna görə də visibility parametri susmaya görə daxili olaraq qalır və məqsədli şəkildə client olaraq təyin edilməlidir.
• Keçidin ləğv edilməsi təsdiq tələb edir, çünki o, həmin keçid vasitəsilə qoşulmuş hər kəsi də kənarlaşdırır — və alət sadəcə quru uğur bildirişi vermək əvəzinə, bunun neçə nəfər olduğunu sizə xəbər verir.

Nə tələb olunur

API və MCP çıxışı Boards Business və bütün Agency hostinq planlarına daxildir. Boards Free və Boards Pro tariflərində lövhə son nöqtələri bunu bildirən mesajla cavab verir.

API açarı və ya MCP bağlantısı yalnız onu yaradan şəxsin səlahiyyəti çatan işləri və yalnız icazəsi olan təşkilatlarda həyata keçirə bilər. Köməkçinin yaratdığı paylaşma keçidi də eyni şəkildə məhdudlaşdırılır: o, səlahiyyət verən şəxsin özündə olmayan rolu başqasına verə bilməz.