Korzystanie z Immich API
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:
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 i pobierz najnowszą wersję.
- Po zainstalowaniu Node.js, NPM (Node Package Manager) zostanie zainstalowany automatycznie.
Konto Immich: Potrzebujesz konta Immich, aby się zalogować i używać CLI.
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ć:
- Zaloguj się na swoje konto Immich w przeglądarce pod adresem https://<twoja-nazwa-użytkownika>.pixelunion.eu
- Przejdź do Ustawień konta i znajdź sekcję Klucze API.
- Kliknij Nowy klucz API i nadaj mu nazwę (np. “Przesyłanie CLI”).
- 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 <url serwera>/api <klucz 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> 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 <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> 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.
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)