--- title: "Usando a API do Immich" description: "" url: "https://pixelunion.eu/pt/blog/immich-api/" date: "2025-04-20" author: "Jochem" categories: ["Guia do usuário","Deep dive"] tags: ["API","CLI","Immich"] --- # O que é uma API? (E por que você deveria se importar?) Imagine que você está em um restaurante. Você olha o cardápio, escolhe seu prato favorito e diz ao garçom o que quer. O garçom leva seu pedido para a cozinha e traz sua comida de volta. Fácil, não? No mundo da tecnologia, uma **API (Interface de Programação de Aplicações)** é como esse garçom. Ela ajuda dois sistemas a conversarem e trocarem informações. Sem APIs, os aplicativos não saberiam como buscar seus vídeos de gatos favoritos, enviar mensagens ou mostrar a previsão do tempo. (E quem quer viver sem vídeos de gatos?) --- # Por que as APIs são tão legais? APIs são como pontes mágicas que conectam diferentes aplicativos e sistemas. Elas fazem tudo funcionar junto de forma suave. Veja o que elas podem fazer: - **Buscar informações**: Como pegar atualizações do tempo ou seu feed de redes sociais. - **Enviar informações**: Como fazer upload de uma foto ou enviar uma mensagem. - **Automatizar tarefas**: Como sincronizar seu calendário com seu e-mail. - **Adicionar recursos legais**: Como mapas ou opções de pagamento em apps. Pense nas APIs como ajudantes invisíveis que tornam seus aplicativos mais inteligentes e sua vida mais fácil. --- # Conheça a API do Immich: Seu superpoder para fotos Agora que você sabe o que são APIs, vamos falar sobre a **API do Immich**. É como um super-herói para suas fotos! Veja o que ela pode fazer por você: - Criar sua própria galeria de fotos personalizada. - Automatizar backups para nunca perder uma memória. - Criar novos aplicativos que funcionam com suas fotos. A API do Immich está aqui para tornar o gerenciamento de fotos divertido, fácil e poderoso. Seja você desenvolvedor ou apenas alguém que ama fotos, ela tem tudo para levar suas fotos ao próximo nível! --- # Conheça o Immich CLI: Seu ajudante no terminal O **Immich CLI (Interface de Linha de Comando)** é como um controle remoto para o Immich que você pode usar direto do terminal do seu computador. É super útil se você quiser enviar fotos rapidamente, organizar álbuns ou automatizar tarefas sem abrir o navegador. ## O que você precisa para usar? Antes de usar o Immich CLI, certifique-se de ter o seguinte: 1. **Node.js e NPM**: O CLI funciona com Node.js, então instale primeiro. - Acesse [nodejs.org](https://nodejs.org) e baixe a versão mais recente. - Ao instalar o Node.js, o NPM (Node Package Manager) é instalado automaticamente. 2. **Conta Immich**: Você precisa de uma conta Immich para fazer login e usar o CLI. 3. **Acesso ao terminal**: Você usará o terminal (ou prompt de comando) para executar os comandos do CLI. ## Como instalar o Immich CLI? Depois de instalar o Node.js e o NPM, instalar o Immich CLI é fácil. Abra o terminal e digite: ``` npm install -g immich-cli ``` --- # Como enviar várias fotos com o Immich CLI Com o Immich CLI você pode enviar várias fotos de uma vez. Veja como fazer passo a passo: ## Passo 1: Obtenha sua chave de API Para usar o CLI, você precisa de uma chave de API do Immich. É como uma senha especial que permite ao CLI acessar sua conta Immich. Veja como conseguir: 1. Faça login na sua conta Immich pelo navegador em https://.pixelunion.eu 2. Vá em **Configurações da conta** e procure a seção **Chaves de API**. 3. Clique em **Nova chave de API** e dê um nome (por exemplo, "Uploads CLI"). 4. Copie a chave gerada. Guarde bem - você vai precisar no próximo passo e ela dá acesso total à sua conta, como uma senha. ## Passo 2: Faça login no CLI Com a chave de API em mãos, faça login no CLI. Abra o terminal e digite: ``` immich /api ``` Por exemplo: ``` immich login https://minhasfotos.pixelunion.eu/api iVAhMOtRARhqHpU6b2NINOPunu0obdEy0SVBtJI5gYmcQOU ``` ## Passo 3: Use o Immich CLI para enviar fotos Depois de logado, você pode começar a enviar suas fotos para o Immich. O CLI é flexível e permite personalizar como você faz upload dos arquivos. Veja como: ### Comando básico para upload Para enviar uma pasta de fotos, use o comando: ``` immich-cli upload /caminho/para/suas/fotos ``` Consulte a ajuda do CLI para mais informações: ``` Usage: immich upload [paths...] [options] Envia arquivos Argumentos: paths Um ou mais caminhos para os arquivos a enviar Opções: -r, --recursive Recursivo (padrão: false, env: IMMICH_RECURSIVE) -i, --ignore Padrão para ignorar (env: IMMICH_IGNORE_PATHS) -h, --skip-hash Não calcular hash antes do upload (padrão: false, env: IMMICH_SKIP_HASH) -H, --include-hidden Incluir pastas ocultas (padrão: false, env: IMMICH_INCLUDE_HIDDEN) -a, --album Criar álbuns automaticamente pelo nome da pasta (padrão: false, env: IMMICH_AUTO_CREATE_ALBUM) -A, --album-name Adicionar todos os arquivos ao álbum especificado (env: IMMICH_ALBUM_NAME) -n, --dry-run Não faz nada, só mostra o que seria feito (padrão: false, env: IMMICH_DRY_RUN) -c, --concurrency Número de arquivos enviados ao mesmo tempo (padrão: 4, env: IMMICH_UPLOAD_CONCURRENCY) --delete Apagar arquivos locais após upload (env: IMMICH_DELETE_ASSETS) --no-progress Ocultar barras de progresso (env: IMMICH_PROGRESS_BAR) --watch Monitorar mudanças e enviar automaticamente (padrão: false, env: IMMICH_WATCH_CHANGES) --help mostrar ajuda para o comando ``` --- # Resumo A API e o CLI do Immich são ferramentas poderosas que tornam o gerenciamento de fotos mais fácil, rápido e flexível. Seja para criar apps próprios, automatizar backups ou enviar grandes coleções, o Immich faz tudo isso possível. Para saber mais sobre o Immich CLI e todos os seus recursos, consulte a documentação oficial: [Documentação CLI Immich](https://immich.app/docs/features/command-line-interface/). Um grande agradecimento à comunidade open source por este projeto incrível. Se você gosta do Immich, apoie o projeto! Aproveite para gerenciar suas fotos! (Imagem de capa de [Douglas lopez](https://unsplash.com/photos/a-laptop-computer-sitting-on-top-of-a-wooden-desk-ehyV_XOZ4iA))