API'den veya bir yapay zeka asistanından panoları yönetin

Panolar, kontrol panelinin dışından tamamen yönetilebilirdir. İki rota, bir yetkilendirme modeli ve ekranlarla aynı davranış — çünkü aynı kodu çağırırlar.

REST API

Her işlem, TypeScript, Python, PHP ve Go dillerinde oluşturulmuş istemcilerle birlikte genel OpenAPI spesifikasyonumuzda yer alır ve CLI da aynı spesifikasyondan üretilir. Panolar, sütunlar, kartlar, yorumlar, sorular, etiketler, üyeler ve paylaşım bağlantılarının tümü kapsam dahilindedir.

En çok kullanacağınız uç noktalar:

• GET /v1/agency/boards — panolarınız
• GET /v1/agency/boards/{id} — sütunları ve kartlarıyla birlikte tek bir pano
• POST /v1/agency/boards/{id}/cards — iş ekleyin
• POST /v1/agency/boards/{id}/cards/{id}/move — işi taşıyın
• POST /v1/agency/boards/{id}/invites — bir paylaşım bağlantısı oluşturun

Paylaşım bağlantısının belirteci (token), son çağrıda ve yalnızca o çağrıda geri döner. Bunun bir parmak izini saklarız, dolayısıyla bunu tekrar okuyabilecek hiçbir uç nokta yoktur — eğer betiğinizin bağlantıya ihtiyacı varsa, onu yanıttan saklayın.

MCP sunucusu

MCP destekleyen bir yapay zeka asistanı kullanıyorsanız, bunu bağlayın; doğrudan pano araçlarına sahip olur: panoları listeleme, bir panoyu tamamen okuma, pano oluşturma, kart ekleme, kart taşıma, yorum yapma, paylaşım bağlantısı oluşturma ve bunu iptal etme. Bu, "bu haftayı özetle ve Acme'ye bir bağlantı gönder" komutunu iki sistem ve bir kopyala-yapıştır yerine tek bir talimata dönüştürür.

Araçlar hakkında bilmeye değer iki şey:

• Aksi belirtilmedikçe yeni bir kart dahilidir. Dahili çalışmanızı özetleyen bir asistan, kimse aksini söylemediği için bu özeti müşterinizle paylaşmamalıdır; bu nedenle visibility varsayılan olarak dahili (internal) ayarlanır ve bilinçli olarak müşteri (client) olarak ayarlanmalıdır.
• Bir bağlantının iptal edilmesi onay ister, çünkü bu aynı zamanda o bağlantı yoluyla katılan herkesi de kaldırır; ve araç, temiz bir başarı raporlamak yerine size bunun kaç kişi olduğunu söyler.

Gereksinimler

API ve MCP erişimi Boards Business sürümünde ve her Agency barındırma planında dahildir. Boards Free ve Boards Pro'da pano uç noktaları bunu belirten bir mesajla yanıt verir.

Bir API anahtarı veya MCP bağlantısı yalnızca onu oluşturan kişinin, yapabileceği yetkiye sahip olduğu organizasyonlarda yapabileceği işlemleri gerçekleştirebilir. Bir asistanın oluşturduğu paylaşım bağlantısı da aynı şekilde sınırlandırılmıştır: yetki veren insanın bizzat sahip olmadığı bir rolü atayamaz.