ცოდნის ბაზა
მართეთ დაფები API-დან ან AI ასისტენტიდან
დაფის ყველა ოპერაცია ხელმისაწვდომია ჩვენს საჯარო API-სა და MCP ხელსაწყოში, ასე რომ, სკრიპტს ან AI აგენტს შეუძლია დაფის წაკითხვა, სამუშაოს დამატება და კლიენტისთვის ბმულის გაგზავნა.
დაფების მართვა სრულად შესაძლებელია სამართავი პანელის გარეშეც. ორი მარშრუტი, ერთი ნებართვების მოდელი და ეკრანების მსგავსი ქცევა — ვინაიდან ისინი იგივე კოდს იძახებენ.
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 კერას შეუძლია გააკეთოს მხოლოდ ის, რისი გაკეთებაც შეუძლია მის შემქმნელს იმ ორგანიზაციებში, სადაც მას ეს ხელეწიფება. ასისტენტის მიერ შექმნილი გაზიარების ბმულიც ასევე შეზღუდულია: მას არ შეუძლია მიანიჭოს როლი, რომელიც ავტორიზებულ ადამიანს თავად არ გააჩნია.
ისევ გაჭედილი ხართ?
მხარდაჭერა შედის ყველა გეგმაში და პასუხები თქვენს საკუთარ ენაზე გაიცემა.
მხარდაჭერასთან დაკავშირება → ყველა სტატია →