Dokumentacja dla programistów›O API monday.com›Pobieranie zasobów (Platform MCP)
Dokumentacja dla programistów

Pobieranie zasobów (Platform MCP)

O API monday.comDokumentacja API
Aktualizacja 2026-09-06

Użyj tego narzędzia, aby pobrać metadane plików (zasobów) przesłanych do monday.com. Podaj jeden lub więcej identyfikatorów zasobów, a narzędzie zwróci informacje o każdym pliku: jego nazwę, rozszerzenie, rozmiar, publiczny adres URL z ograniczonym czasem ważności, który umożliwia pobranie lub wyświetlenie pliku, adres URL miniatury (w przypadku obrazów), datę przesłania oraz nazwę użytkownika, który przesłał plik.

Identyfikatory zasobów pojawiają się w odpowiedziach API, gdy pliki są dołączane do elementów, aktualizacji lub dokumentów. Możesz je też znaleźć, sprawdzając wartości kolumn elementów, które korzystają z kolumn plików, za pomocą get_full_board_data albo wywołując update_doc z blokiem image, który odwołuje się do asset_id.

Publiczny adres URL zwracany dla każdego zasobu jest ważny przez 1 godzinę. Nie zapisuj go ani nie udostępniaj do długotrwałego użytku - pobierz dane zasobu ponownie, aby otrzymać nowy adres URL.

Parametry

Parametr Typ Wymagane Opis
ids array Tak Tablica identyfikatorów zasobów do pobrania. Musi zawierać co najmniej jeden identyfikator. Identyfikatory zasobów są ciągami cyfr (np. ["12345678"]).

Przykład

Pobierz metadane dwóch zasobów:

{
  "ids": ["12345678", "87654321"]
}

Dla każdego prawidłowego identyfikatora zasobu narzędzie zwraca:

  • name - oryginalną nazwę pliku (np. "screenshot.png")
  • file_extension - typ pliku (np. "png", "pdf")
  • file_size - rozmiar w bajtach
  • public_url - adres URL z ograniczonym czasem ważności (ważny przez 1 godzinę), umożliwiający bezpośredni dostęp do pliku
  • thumbnail_url - adres URL obrazu podglądu (w przypadku zasobów będących obrazami)
  • created_at - znacznik czasu przesłania
  • uploaded_by - nazwa i identyfikator użytkownika, który przesłał plik

Jeśli identyfikator nie zostanie znaleziony, narzędzie zwróci komunikat informujący, że nie znaleziono zasobów o tym identyfikatorze. Sprawdź, czy identyfikator jest prawidłowy i czy należy do zasobu na Twoim koncie.


Odpowiednik programistyczny

Aby uzyskać ten sam wynik, użyj GraphQL API:

query {
  assets(ids: [12345678, 87654321]) {
    id
    name
    file_extension
    file_size
    public_url
    created_at
    uploaded_by {
      id
      name
    }
  }
}

Pełną dokumentację znajdziesz w sekcji Assets.