Pobieranie szczegółowych informacji o typie (Platform MCP)
get_type_details wyszukuje konkretny typ GraphQL według nazwy i zwraca jego pełną definicję: wszystkie pola, ich typy zwracane, możliwość przyjmowania wartości null oraz argumenty akceptowane przez każde pole. Użyj tego narzędzia po get_graphql_schema, aby poznać dokładną strukturę typu, zanim utworzysz zapytanie za pomocą all_monday_api.
Przydaje się to szczególnie w przypadku złożonych typów obiektów, takich jak Board, Item czy Column, które mają wiele pól i zagnieżdżonych argumentów trudnych do zapamiętania.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| typeName | string |
Tak | Dokładna nazwa typu GraphQL do sprawdzenia. W nazwach typów rozróżniana jest wielkość liter (np. "Board", "Item", "Column"). |
Przykład
Pobierz wszystkie pola typu Board:
{
"typeName": "Board"
}
Odpowiedź zawiera rodzaj typu (OBJECT), opis i tablicę fields. Każdy wpis w tej tablicy zawiera nazwę i opis pola, jego typ zwracany (z informacją o możliwości przyjmowania wartości null i zagnieżdżeniu) oraz akceptowane argumenty. Typ Board zawiera na przykład pola takie jak:
| Pole | Typ | Uwagi |
|---|---|---|
id |
ID! |
Unikalny identyfikator tablicy |
name |
String! |
Nazwa tablicy |
columns |
[Column] |
Akceptuje argumenty filtrujące ids, types i capabilities |
items_page |
ItemsResponse! |
Akceptuje argumenty cursor, limit i query_params do stronicowania |
groups |
[Group] |
Akceptuje opcjonalny filtr ids |
state |
State! |
Aktywna, zarchiwizowana lub usunięta |
board_kind |
BoardKind! |
Publiczna, prywatna lub udostępniona |
workspace |
Workspace |
Wartość null dla głównego obszaru roboczego |
Możesz użyć dowolnej nazwy typu z tablicy types zwróconej przez get_graphql_schema - na przykład "Item", "Column", "User", "Group", "Workspace", "Update" lub typów wejściowych, takich jak "ItemsQuery".
Odpowiednik programistyczny
Te same informacje możesz pobrać za pomocą zapytania introspekcyjnego GraphQL:
{
__type(name: "Board") {
name
kind
description
fields {
name
description
type {
name
kind
ofType {
name
kind
}
}
args {
name
type {
name
kind
}
}
}
}
}
Dokumentację pól w czytelnej dla człowieka formie znajdziesz w dokumentacji API monday.com.