Pliki przesłane do monday.com są zapisywane jako zasoby. Każdy zasób ma unikalny identyfikator, który pozwala rozpoznać go w ramach konta.

Zapytania

Pobieranie zasobów

• Wymagany zakres:assets:read
• Zwraca tablicę zawierającą metadane jednego zasobu lub ich zbioru.
• Zapytanie można wykonać bezpośrednio na poziomie głównym za pomocą argumentu ids albo zagnieździć je w zapytaniu items lub updates.

query {
  boards (ids:1234567890) {
    items_page (limit:100) {
      items {
        assets {
          id
          url
          name
        }
      }
    }
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($boardId: [ID!]) { boards (ids: $boardId) { items_page (limit: 100) { items { assets { id url name } } } } }`;
const variables = {
  boardId: 12345,
};
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
ids	[ID!]!	Unikalne identyfikatory zasobów.

Pola

Pole	Typ	Opis
created_at	Date	Data utworzenia zasobu.
file_extension	String!	Rozszerzenie pliku zasobu.
file_size	Int!	Rozmiar zasobu w bajtach.
id	ID!	Unikalny identyfikator zasobu.
name	String!	Nazwa zasobu.
original_geometry	String	Oryginalna geometria zasobu.
public_url	String!	Publiczny adres URL zasobu (ważny przez 1 godzinę). Użytkownicy bez profilu monday.com mogą otworzyć ten link i zobaczyć plik, dopóki jest ważny.
uploaded_by	User!	Użytkownik, który przesłał zasób. To pole nie zwróci żadnej wartości, jeśli zasób jest duplikatem elementu wygenerowanego przez system.
url	String!	Adres URL zasobu. Jest dostępny tylko dla użytkowników, którzy mają dostęp do pliku na swoim koncie. Jeśli zasób jest przechowywany na tablicy prywatnej lub do udostępniania, musi też należeć do tej tablicy.
url_thumbnail	String	Adres URL umożliwiający wyświetlenie zasobu jako miniatury. Dostępny tylko dla obrazów.

Mutacje

Za pomocą API możesz przesyłać do monday.com pliki JPEG, Word/Doc, PDF, XLSX, GIF, MP4, CSV, SVG, TXT i AI. Pliki są zapisywane jako zasoby i zawsze należą do obiektu nadrzędnego, takiego jak element lub aktualizacja.

Wysyłanie żądań multipart

Jeśli wysyłasz bezpośrednie żądania do API, musisz użyć typu zawartości multipart/form-data, zgodnie z opisem w naszej społeczności. W zależności od języka programowania lub biblioteki może być konieczne ręczne skonstruowanie treści żądania HTTP typu multipart. Przykład w JavaScript znajdziesz w tym wpisie w społeczności.

Dodawanie pliku do aktualizacji

Wymagany zakres:updates:write

Dodaje plik na końcu aktualizacji. Zwraca Asset.

mutation {
  add_file_to_update(
    update_id: 1234567890
    file: YOUR_FILE
    ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
file	File!	Plik do przesłania.
update_id	ID!	Unikalny identyfikator aktualizacji, do której zostanie dodany plik. Możesz też użyć identyfikatora odpowiedzi, aby dodać plik do odpowiedzi na aktualizację.

Dodawanie pliku do kolumny

Wymagany zakres:boards:write

Dodaje plik do kolumny plików (Files) określonego elementu. Zwraca Asset.

mutation {
  add_file_to_column(
    item_id: 1234567890 
    column_id: "files" 
    file: YOUR_FILE
  ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
column_id	String!	Unikalny identyfikator kolumny, do której zostanie dodany plik.
file	File!	Plik do przesłania.
item_id	ID!	Unikalny identyfikator elementu, do którego zostanie dodany plik.