მართეთ დაფები API-დან ან ხელოვნური ინტელექტის ასისტენტიდან

დაფების მართვა სრულად არის შესაძლებელი მართვის პანელის გარედანაც. ორი მარშრუტი, ერთი ნებართვების მოდელი და ეკრანების იდენტური ქცევა — რადგან ისინი ერთსა და იმავე კოდს იძახებენ.

REST API

თითოეული ოპერაცია მოცემულია ჩვენს საჯარო OpenAPI სპეციფიკაციაში, გენერირებული კლიენტებით TypeScript, Python, PHP და Go ენებზე, ხოლო CLI გენერირებულია იმავე სპეციფიკაციიდან. დაფები, სვეტები, ბარათები, კომენტარები, კითხვები, იარლიყები, წევრები და გაზიარების ბმულები სრულად არის დაფარული.

ბოლოწერტილები, რომლებსაც ყველაზე ხშირად გამოიყენებთ:

• GET /v1/agency/boards — თქვენი დაფები
• GET /v1/agency/boards/{id} — ერთი დაფა თავისი სვეტებითა და ბარათებით
• POST /v1/agency/boards/{id}/cards — სამუშაოს დამატება
• POST /v1/agency/boards/{id}/cards/{id}/move — მისი გადაადგილება
• POST /v1/agency/boards/{id}/invites — გაზიარების ბმულის გენერირება

გაზიარების ბმულის ტოკენი ბრუნდება ამ ბოლო გამოძახებისას და მხოლოდ ამ გამოძახებისას. ჩვენ ვინახავთ მის ანაბეჭდს, ამიტომ არ არსებობს ბოლოწერტილი, რომელსაც მისი ხელახლა წაკითხვა შეუძლია — თუ თქვენს სკრიპტს ბმული სჭირდება, შეინახეთ იგი პასუხიდან.

MCP სერვერი

თუ იყენებთ AI ასისტენტს, რომელსაც აქვს MCP-ის მხარდაჭერა, დააკავშირეთ იგი და ის პირდაპირ მიიღებს დაფის ხელსაწყოებს: დაფების ჩამოთვლა, ერთის სრულად წაკითხვა, დაფის შექმნა, ბარათის დამატება, ბარათის გადაადგილება, კომენტირება, გაზიარების ბმულის შექმნა და მისი გაუქმება. ეს აქცევს ბრძანებას „შეაჯამე ეს კვირა და გაუგზავნე ბმული Acme-ს“ ერთ ინსტრუქციად, ორ სისტემასა და კოპირება-ჩასმას შორის მოქმედებების ნაცვლად.

ორი რამ, რაც ხელსაწყოების შესახებ უნდა იცოდეთ:

• ახალი ბარათი შიდაა, თუ სხვაგვარად არ მიუთითებთ. ასისტენტმა, რომელიც თქვენს შიდა სამუშაოს აჯამებს, არ უნდა გამოუქვეყნოს ეს შეჯამება თქვენს კლიენტს მხოლოდ იმიტომ, რომ საპირისპირო არავის უთქვამს, ამიტომ visibility ნაგულისხმევად არის შიდა და იგი მიზანმიმართულად უნდა დაყენდეს მნიშვნელობაზე client.
• ბმულის გაუქმება მოითხოვს დადასტურებას, რადგან ის ასევე შლის ნებისმიერ პირს, ვინც ამ ბმულის მეშვეობით შემოუერთდა — და ხელსაწყო გატყობინებთ, რამდენი ადამიანი იყო ეს, უბრალო წარმატების შეტყობინების ნაცვლად.

რა არის საჭირო

API და MCP წვდომა შედის Boards Business-ში და ყველა Agency ჰოსტინგის გეგმაში. Boards Free-სა და Boards Pro-ზე დაფის ბოლოწერტილები პასუხობენ შეტყობინებით, რომელიც ამის შესახებ იუწყება.

API გასაღებს ან MCP კავშირს შეუძლია მხოლოდ იმის გაკეთება, რისი გაკეთებაც შეუძლია მის შემქმნელ პირს იმ ორგანიზაციებში, სადაც მას ამის უფლება აქვს. ასისტენტის მიერ შექმნილი გაზიარების ბმული შეზღუდულია იმავე წესით: მას არ შეუძლია მიანიჭოს როლი, რომელსაც თავად ავტორიზატორი პირი არ ფლობს.