Οι πίνακες είναι πλήρως διαχειρίσιμοι έξω από τον πίνακα ελέγχου. Δύο διαδρομές, ένα μοντέλο δικαιωμάτων και η ίδια συμπεριφορά με τις οθόνες — επειδή καλούν τον ίδιο κώδικα.
Το 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
Εάν χρησιμοποιείτε έναν βοηθό τεχνητής νοημοσύνης που υποστηρίζει MCP, συνδέστε τον και λαμβάνει εργαλεία πινάκων απευθείας: προβολή πινάκων, πλήρη ανάγνωση ενός πίνακα, δημιουργία πίνακα, προσθήκη κάρτας, μετακίνηση κάρτας, σχολιασμό, δημιουργία συνδέσμου κοινής χρήσης και ανάκληση συνδέσμου. Αυτό μετατρέπει το «κάνε μια σύνοψη αυτής της εβδομάδας και στείλε έναν σύνδεσμο στην Acme» σε μία μόνο οδηγία αντί για δύο συστήματα και αντιγραφή-επικόλληση.
Δύο πράγματα που αξίζει να γνωρίζετε για τα εργαλεία:
- Μια νέα κάρτα είναι εσωτερική, εκτός αν ορίσετε διαφορετικά. Ένας βοηθός που συνοψίζει την εσωτερική εργασία σας δεν πρέπει να δημοσιεύει αυτήν τη σύνοψη στον πελάτη σας επειδή κανείς δεν είπε να μην το κάνει, επομένως το
visibility ορίζεται από προεπιλογή ως εσωτερικό και πρέπει να ρυθμιστεί σε client σκόπιμα.
- Η ανάκληση ενός συνδέσμου απαιτεί επιβεβαίωση, επειδή καταργεί επίσης οποιονδήποτε συμμετείχε μέσω αυτού του συνδέσμου — και το εργαλείο σας ενημερώνει πόσα άτομα ήταν αυτά, αντί να αναφέρει απλώς μια τακτοποιημένη επιτυχία.
Τι χρειάζεται
Η πρόσβαση σε API και MCP περιλαμβάνεται στο Boards Business και σε κάθε πρόγραμμα φιλοξενίας Agency. Στο Boards Free και στο Boards Pro τα τελικά σημεία των πινάκων απαντούν με ένα σχετικό μήνυμα.
Ένα κλειδί API ή μια σύνδεση MCP μπορεί να εκτελέσει μόνο ό,τι μπορεί να κάνει το άτομο που το δημιούργησε, στους οργανισμούς στους οποίους έχει τη σχετική δυνατότητα. Ένας σύνδεσμος κοινής χρήσης που δημιουργεί ένας βοηθός περιορίζεται με τον ίδιο τρόπο: δεν μπορεί να παραχωρήσει έναν ρόλο τον οποίο ο εξουσιοδοτών άνθρωπος δεν κατέχει ο ίδιος.