--- title: "Korzystanie z Immich API" description: "" url: "https://pixelunion.eu/pl/blog/immich-api/" date: "2025-04-20" author: "Jochem" categories: ["Przewodnik użytkownika","Pogłębienie"] tags: ["API","CLI","Immich"] --- # Czym jest API? (I dlaczego powinno cię to obchodzić?) Wyobraź sobie: siedzisz w restauracji. Przeglądasz menu, wybierasz ulubione danie i mówisz kelnerowi, czego chcesz. Kelner zanosi twoje zamówienie do kuchni i wraca z jedzeniem. Proste, prawda? W świecie technologii **API (Application Programming Interface)** jest właśnie takim kelnerem. Zapewnia, że dwa systemy mogą się ze sobą komunikować i wymieniać informacje. Bez API aplikacje nie wiedziałyby, jak pobierać ulubione filmiki z kotkami, wysyłać wiadomości ani wyświetlać pogody. (A kto chciałby żyć bez filmików z kotkami?) --- # Dlaczego API są takie przydatne? API to jak magiczne mosty łączące różne aplikacje i systemy. Sprawiają, że wszystko sprawnie współdziała. Mogą na przykład: - **Pobierać rzeczy**: Takie jak prognoza pogody lub feed mediów społecznościowych. - **Wysyłać rzeczy**: Takie jak przesyłanie zdjęcia lub wysyłanie wiadomości. - **Automatyzować działania**: Takie jak synchronizacja kalendarza z pocztą e-mail. - **Dodawać fajne funkcje**: Takie jak mapy lub opcje płatności w aplikacjach. Traktuj API jako niewidocznych pomocników, którzy sprawiają, że twoje aplikacje są mądrzejsze, a życie łatwiejsze. --- # Poznaj Immich API: Twoja fotograficzna supermoc Teraz, gdy wiesz, czym są API, porozmawiajmy o **Immich API**. To jak superbohater dla twoich zdjęć! Oto co możesz z nim zrobić: - Zbudować własną galerię zdjęć. - Zautomatyzować kopie zapasowe, aby nigdy nie stracić wspomnienia. - Tworzyć nowe aplikacje współpracujące z twoimi zdjęciami. Immich API sprawia, że zarządzanie zdjęciami jest przyjemne, łatwe i potężne. Niezależnie od tego, czy jesteś deweloperem, czy po prostu kochasz zdjęcia, masz wszystko, czego potrzebujesz, aby przenieść swoje fotografie na wyższy poziom! --- # Poznaj Immich CLI: Twój pomocnik wiersza poleceń **Immich CLI (Command-Line Interface)** to jak pilot zdalnego sterowania dla Immich, którego możesz używać bezpośrednio z terminala. Niezwykle przydatny, gdy chcesz szybko przesłać zdjęcia, organizować albumy lub automatyzować zadania bez otwierania przeglądarki. ## Czego potrzebujesz, żeby z niego korzystać? Zanim będziesz mógł używać Immich CLI, upewnij się, że masz: 1. **Node.js i NPM**: CLI działa na Node.js, więc najpierw musisz go zainstalować. Nie martw się, to proste! - Przejdź na [nodejs.org](https://nodejs.org) i pobierz najnowszą wersję. - Po zainstalowaniu Node.js, NPM (Node Package Manager) zostanie zainstalowany automatycznie. 2. **Konto Immich**: Potrzebujesz konta Immich, aby się zalogować i używać CLI. 3. **Dostęp do terminala**: Używasz terminala (lub wiersza polecenia) do uruchamiania poleceń CLI. ## Jak zainstalować Immich CLI Gdy masz Node.js i NPM, instalacja Immich CLI jest bułką z masłem. Otwórz terminal i wpisz: ``` npm install -g immich-cli ``` --- # Jak przesłać wiele zdjęć za pomocą Immich CLI Za pomocą Immich CLI możesz bardzo łatwo przesłać wiele zdjęć naraz. Oto jak to zrobić krok po kroku: ## Krok 1: Pobierz swój klucz API Aby używać CLI, potrzebujesz klucza API z Immich. Traktuj go jak specjalne hasło, które pozwala CLI komunikować się z twoim kontem Immich. Oto jak go uzyskać: 1. Zaloguj się na swoje konto Immich w przeglądarce pod adresem https://.pixelunion.eu 2. Przejdź do **Ustawień konta** i znajdź sekcję **Klucze API**. 3. Kliknij **Nowy klucz API** i nadaj mu nazwę (np. "Przesyłanie CLI"). 4. Skopiuj wygenerowany klucz API. Zachowaj go bezpiecznie - będziesz go potrzebować i daje dostęp do całego twojego konta, podobnie jak hasło! ## Krok 2: Zaloguj się za pomocą CLI Gdy masz klucz API, możesz zalogować się za pomocą CLI. Otwórz terminal i wpisz: ``` immich /api ``` Na przykład: ``` immich login https://mojezdjecia.pixelunion.eu/api iVAhMOtRARhqHpU6b2NINOPunu0obdEy0SVBtJI5gYmcQOU ``` ## Krok 3: Użyj Immich CLI do przesyłania Po zalogowaniu możesz zacząć przesyłać zdjęcia do Immich. CLI oferuje dużą elastyczność, dzięki czemu możesz samodzielnie decydować, jak przesyłać pliki. Oto jak to działa: ### Podstawowe polecenie przesyłania Aby przesłać folder ze zdjęciami, użyj następującego polecenia: ``` immich-cli upload /ścieżka/do/twoich/zdjęć ``` Zobacz pomoc dla polecenia CLI, aby uzyskać więcej informacji: ``` Usage: immich upload [paths...] [options] Upload assets Arguments: paths One or more paths to assets to be uploaded Options: -r, --recursive Recursive (default: false, env: IMMICH_RECURSIVE) -i, --ignore Pattern to ignore (env: IMMICH_IGNORE_PATHS) -h, --skip-hash Don't hash files before upload (default: false, env: IMMICH_SKIP_HASH) -H, --include-hidden Include hidden folders (default: false, env: IMMICH_INCLUDE_HIDDEN) -a, --album Automatically create albums based on folder name (default: false, env: IMMICH_AUTO_CREATE_ALBUM) -A, --album-name Add all assets to specified album (env: IMMICH_ALBUM_NAME) -n, --dry-run Don't perform any actions, just show what will be done (default: false, env: IMMICH_DRY_RUN) -c, --concurrency Number of assets to upload at the same time (default: 4, env: IMMICH_UPLOAD_CONCURRENCY) --delete Delete local assets after upload (env: IMMICH_DELETE_ASSETS) --no-progress Hide progress bars (env: IMMICH_PROGRESS_BAR) --watch Watch for changes and upload automatically (default: false, env: IMMICH_WATCH_CHANGES) --help display help for command ``` --- # Podsumowanie Immich API i CLI to potężne narzędzia, które sprawiają, że zarządzanie zdjęciami jest łatwiejsze, szybsze i przyjemniejsze. Niezależnie od tego, czy budujesz własne aplikacje, automatyzujesz kopie zapasowe, czy przesyłasz ogromną bibliotekę zdjęć: Immich ci w tym pomoże. Chcesz głębiej zanurzyć się w Immich CLI i odkryć wszystkie możliwości? Zajrzyj do oficjalnej dokumentacji: [Dokumentacja Immich CLI](https://immich.app/docs/features/command-line-interface/). Wielkie podziękowania dla społeczności open source za tworzenie i utrzymywanie tego wspaniałego oprogramowania. Immich nie byłby możliwy bez zaangażowania i ciężkiej pracy deweloperów na całym świecie. Lubisz Immich? Rozważ współtworzenie lub wsparcie projektu! Miłego zarządzania zdjęciami! (Zdjęcie okładkowe autorstwa [Douglas Lopez](https://unsplash.com/photos/a-laptop-computer-sitting-on-top-of-a-wooden-desk-ehyV_XOZ4iA))