Dokumentacja dla programistów

Uzyskaj adres URL do przesłania zasobu (Platform MCP)

Aktualizacja 2026-09-06

Użyj tego narzędzia, aby uzyskać wstępnie podpisany adres URL do przesłania pliku do monday.com. Narzędzie zwraca upload_id i upload_url. To pierwszy krok trzyetapowego procesu przesyłania - po przesłaniu pliku pod zwrócony adres URL wywołaj finalize_asset_upload, aby utworzyć zasób i dołączyć go do elementu.

To narzędzie działa ze schematem API dev (preview) monday.com (create_upload). Bazowe API może się zmieniać, dopóki nie zostanie udostępnione jako stabilna wersja API.

Pełny proces przesyłania wygląda następująco:

get_asset_upload_url ← Jesteś tutaj - uzyskaj upload_id i upload_url.
Prześlij plik - wyślij plik pod adres upload_url za pomocą żądania HTTP PUT i zapisz nagłówek odpowiedzi ETag.
finalize_asset_upload - zakończ przesyłanie za pomocą upload_id i etag, a następnie dołącz zasób do kolumny plików lub dokumentów.

Parametry

Parametr	Typ	Wymagane	Opis
fileName	`string`	Tak	Nazwa przesyłanego pliku wraz z rozszerzeniem (np. "report.pdf").
contentType	`string`	Tak	Typ MIME pliku (np. "application/pdf", "image/png", "text/plain").
fileSize	`number`	Tak	Rozmiar pliku w bajtach. Maksymalnie 500 MB (524288000 bajtów).

Przykład

Poproś o adres URL do przesłania pliku PDF:

{
  "fileName": "report.pdf",
  "contentType": "application/pdf",
  "fileSize": 248320
}

Narzędzie zwraca upload_id, upload_url i znacznik czasu url_expires_at. Prześlij plik za pomocą PUT i zapisz nagłówek ETag:

curl -i -X PUT "<upload_url>" \
  -H "Content-Type: application/pdf" \
  --data-binary @report.pdf

Zapisz wartość ETag z odpowiedzi - przekażesz ją do finalize_asset_upload.

Odpowiednik programistyczny

To narzędzie odpowiada mutacji create_upload w schemacie API dev (preview) monday.com. Nie ma jeszcze stabilnego, publicznego odpowiednika w GraphQL. Informacje o pracy z plikami w stabilnym API znajdziesz w sekcji Zasoby.

Mam problem z tym tematem Źródło: developer.monday.com