Hvad er en API? (Og hvorfor skal du bekymre dig?)

Forestil dig, at du er på en restaurant. Du kigger på menuen, vælger din yndlingsret og fortæller tjeneren, hvad du vil have. Tjeneren bringer din ordre til køkkenet og bringer din mad tilbage til dig. Nemt, ikke?

I tech-verdenen er en API (Application Programming Interface) som den tjener. Den hjælper to systemer med at tale sammen og dele information. Uden API’er ville apps ikke vide, hvordan de skulle hente dine yndlingskattevideoer, sende beskeder eller endda vise dig vejret. (Og hvem vil leve uden kattevideoer?)

Hvorfor er API’er så seje?

API’er er som magiske broer, der forbinder forskellige apps og systemer. De får alt til at fungere sammen problemfrit. Her er hvad de kan:

• Hente ting: Som at hente vejropdateringer eller dit feed fra sociale medier.
• Sende ting: Som at uploade et foto eller sende en besked.
• Gøre ting automatisk: Som at synkronisere din kalender med din e-mail.
• Tilføje seje funktioner: Som at tilføje kort eller betalingsmuligheder til apps.

Tænk på API’er som de usynlige hjælpere, der gør dine apps klogere og dit liv nemmere.

Mød Immich API: Din foto-superkraft

Nu hvor du ved, hvad API’er er, lad os tale om Immich API. Den er som en superhelt for dine fotos! Her er hvad den kan hjælpe dig med:

• Bygge dit eget brugerdefinerede fotogalleri.
• Automatisere backups, så du aldrig mister et minde.
• Oprette nye apps, der fungerer med dine fotos.

Immich API er her for at gøre styring af dine fotos sjovt, nemt og kraftfuldt. Uanset om du er udvikler eller bare én, der elsker fotos, har den alt hvad du behøver for at tage dit fotospil til næste niveau!

Mød Immich CLI: Din kommandolinje-hjælper

Immich CLI (Command-Line Interface) er som en fjernbetjening til Immich, som du kan bruge direkte fra din computers terminal. Den er super praktisk, hvis du vil uploade fotos hurtigt, organisere albummer eller automatisere opgaver uden at åbne en browser.

Hvad har du brug for for at bruge den?

Før du kan bruge Immich CLI, sørg for at have disse ting klar:

1. Node.js og NPM:
   CLI’en kører på Node.js, så du skal installere det først. Bare rolig, det er nemt!

   • Gå til nodejs.org og download den seneste version.
   • Når du installerer Node.js, installeres NPM (Node Package Manager) også for dig.

2. Immich-konto:
   Du har brug for en Immich-konto for at logge ind og bruge CLI’en.

3. Terminaladgang:
   Du bruger din terminal (eller kommandoprompt) til at køre CLI-kommandoerne.

Sådan installerer du Immich CLI

Når du har Node.js og NPM installeret, er installation af Immich CLI en leg. Åbn bare din terminal og skriv denne kommando:

npm install -g immich-cli

Sådan uploader du masser af fotos med Immich CLI

Immich CLI gør det super nemt at uploade en masse fotos på én gang. Sådan gør du trin for trin:

Trin 1: Få din API-nøgle

For at bruge CLI’en har du brug for en API-nøgle fra Immich. Tænk på den som en særlig adgangskode, der lader CLI’en tale med din Immich-konto. Sådan får du den:

1. Log ind på din Immich-konto i din browser via https://.pixelunion.eu
2. Gå til Kontoindstillinger og find sektionen API-nøgler.
3. Klik på Ny API-nøgle og giv den et navn (f.eks. “CLI Uploads”).
4. Kopier den genererede API-nøgle. Gem den sikkert – du får brug for den i næste trin, og den giver adgang til hele din konto, som en adgangskode!

Trin 2: Log ind i CLI’en

Når du har din API-nøgle, kan du logge ind i CLI’en. Åbn din terminal og skriv:

immich <server url>/api <api key>

For eksempel:

immich login https://myphotos.pixelunion.eu/api iVAhMOtRARhqHpU6b2NINOPunu0obdEy0SVBtJI5gYmcQOU

Trin 3: Brug Immich CLI til at starte upload

Når du er logget ind, kan du begynde at uploade dine fotos til Immich. CLI’en giver meget fleksibilitet, så du kan tilpasse hvordan du uploader dine filer. Sådan gør du:

Basis upload-kommando

For at uploade en mappe med fotos brug følgende kommando:

immich-cli upload  /path/to/your/photos

Se hjælpen for CLI-kommandoen for mere 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

Afslutning

Immich API og CLI er kraftfulde værktøjer, der gør styring af dine fotos nemmere, hurtigere og mere sjovt. Uanset om du bygger brugerdefinerede apps, automatisérer backups eller uploader et massivt fotobibliotek, har Immich dig dækket.

Hvis du vil dykke dybere ned i Immich CLI og udforske alle dens funktioner, tjek den officielle dokumentation her: Immich CLI Documentation.

Et stort tak til open-source-communityet for at skabe og vedligeholde dette fantastiske stykke software. Immich ville ikke være mulig uden dedikationen og det hårde arbejde fra udviklere rundt om i verden. Hvis du elsker Immich, overvej at bidrage eller støtte projektet!

God fotostyring!

(omslagsbillede af Douglas lopez)