Använda Immich API
Vad är en API? (Och varför bör du bry dig?)
Föreställ dig att du är på en restaurang. Du tittar på menyn, väljer din favoriträtt och berättar för servitören vad du vill ha. Servitören tar din beställning till köket och kommer tillbaka med din mat. Enkelt, eller hur?
I teknikvärlden är en API (Application Programming Interface) som den servitören. Den hjälper två system att prata med varandra och dela information. Utan API:er skulle appar inte veta hur de ska hämta dina favoritkattvideor, skicka meddelanden eller ens visa dig vädret. (Och vem vill leva utan kattvideor?)
Varför är API:er så coola?
API:er är som magiska broar som kopplar samman olika appar och system. De gör att allt fungerar tillsammans smidigt. Här är vad de kan göra:
- Hämta saker: Som att hämta väderuppdateringar eller din sociala mediefeed.
- Skicka saker: Som att ladda upp ett foto eller skicka ett meddelande.
- Göra saker automatiskt: Som att synkronisera din kalender med din e-post.
- Lägga till coola funktioner: Som att lägga till kartor eller betalningsalternativ i appar.
Tänk på API:er som de osynliga hjälparna som gör dina appar smartare och ditt liv enklare.
Möt Immich API: Din fotosuperkraft
Nu när du vet vad API:er är, låt oss prata om Immich API. Det är som en superhjälte för dina foton! Här är vad det kan hjälpa dig göra:
- Bygg din egen anpassade fotogalleri.
- Automatisera säkerhetskopior så att du aldrig förlorar ett minne.
- Skapa nya appar som fungerar med dina foton.
Immich API är här för att göra hanteringen av dina foton rolig, enkel och kraftfull. Oavsett om du är en utvecklare eller bara någon som älskar foton, har den allt du behöver för att ta ditt fotospel till nästa nivå!
Möt Immich CLI: Din kommandoradshjälpare
Immich CLI (Command-Line Interface) är som en fjärrkontroll för Immich som du kan använda direkt från din dators terminal. Den är superpraktisk om du vill snabbt ladda upp foton, organisera album eller automatisera uppgifter utan att öppna en webbläsare.
Vad behöver du för att använda den?
Innan du kan använda Immich CLI, se till att du har dessa saker redo:
Node.js och NPM:
CLI:n körs på Node.js, så du behöver installera den först. Oroa dig inte, det är enkelt!- Gå till nodejs.org och ladda ner den senaste versionen.
- När du installerar Node.js installeras även NPM (Node Package Manager) för dig.
Immich-konto:
Du behöver ett Immich-konto för att logga in och använda CLI:n.Terminalåtkomst:
Du kommer att använda din terminal (eller kommandotolk) för att köra CLI-kommandona.
Hur du installerar Immich CLI
När du har installerat Node.js och NPM är det enkelt att installera Immich CLI. Öppna bara din terminal och skriv detta kommando:
npm install -g immich-cli
Hur du laddar upp många foton med Immich CLI
Immich CLI gör det superenkelt att ladda upp massor av foton på en gång. Så här gör du det steg för steg:
Steg 1: Hämta din API-nyckel
För att använda CLI:n behöver du en API-nyckel från Immich. Tänk på det som ett speciellt lösenord som låter CLI:n prata med ditt Immich-konto. Så här hämtar du den:
- Logga in på ditt Immich-konto i din webbläsare via https://<ditt-användarnamn>.pixelunion.eu
- Gå till Kontoinställningar och hitta avsnittet API-nycklar.
- Klicka på Ny API-nyckel och ge den ett namn (t.ex. “CLI-uppladdningar”).
- Kopiera den genererade API-nyckeln. Håll den säker—du behöver den i nästa steg och den ger åtkomst till hela ditt konto, som ett lösenord!
Steg 2: Logga in på CLI:n
När du har din API-nyckel kan du logga in på CLI:n. Öppna din terminal och skriv:
immich <server url>/api <api key>
Till exempel:
immich login https://minafoton.pixelunion.eu/api iVAhMOtRARhqHpU6b2NINOPunu0obdEy0SVBtJI5gYmcQOU
Steg 3: Använd Immich CLI för att börja ladda upp
När du är inloggad kan du börja ladda upp dina foton till Immich. CLI:n ger mycket flexibilitet, så du kan anpassa hur du laddar upp dina filer. Så här gör du:
Grundläggande uppladdningskommando
För att ladda upp en mapp med foton, använd följande kommando:
immich-cli upload /sökväg/till/dina/foton
Se hjälpen för CLI-kommandot för mer information:
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
Sammanfattning
Immich API och CLI är kraftfulla verktyg som gör hanteringen av dina foton enklare, snabbare och roligare. Oavsett om du bygger anpassade appar, automatiserar säkerhetskopior eller laddar upp ett enormt fotobibliotek, har Immich dig täckt.
Om du vill dyka djupare in i Immich CLI och utforska alla dess funktioner, kolla in den officiella dokumentationen här: Immich CLI-dokumentation.
Ett stort tack till open source-gemenskapen för att skapa och underhålla denna fantastiska programvara. Immich skulle inte vara möjligt utan engagemanget och hårt arbete från utvecklare runt om i världen. Om du älskar Immich, överväg att bidra eller stödja projektet!
Lycka till med fotohanteringen!
(omslagsbild av Douglas lopez)