← Voltar à página inicial

Configurar a captura

O endpoint de captura transforma qualquer pedido HTTP numa tarefa. Um Atalho no telemóvel, uma regra no cliente de mail, uma linha num script — qualquer coisa que faça POST.

Obtém o teu link

No okdone, abre Definições → Captura e carrega em Criar link de captura. Recebes um endereço como https://okdone.app/api/capture/<token>.

Esse link é a credencial. Quem o tiver pode meter tarefas na tua conta, por isso trata-o como uma palavra-passe. Se sair cá para fora, carrega em Rodar link e o antigo deixa de funcionar de imediato.

macOS — pedir uma tarefa

O do dia a dia: um atalho de teclado que abre uma caixa, recebe uma linha de texto, envia-a e sai da frente.

  1. Abre o Shortcuts → Ficheiro → Novo atalho. Chama-lhe Add to okdone.
  2. Procura Ask for Input na lista de ações e arrasta-a. Deixa o tipo em Text, põe Prompt em New task e deixa Default Answer vazio — o que lá estiver preenche a caixa e vais apagá-lo sempre. Marca Allow Multiple Lines.
  3. Adiciona Get Contents of URL por baixo e cola o teu link de captura no campo do URL.
  4. Carrega em Show More para abrir as opções e põe Method em POST.
  5. Em Headers, adiciona uma linha: chave Content-Type, valor text/plain.
  6. Põe Request Body em File. No campo que aparece, escolhe a variável mágica da primeira ação — conforme a versão do macOS aparece como Ask for Input ou Provided Input.
  7. Carrega em ▶ para testar. Da primeira vez pede autorização para contactar o servidor; concede-a.

As versões recentes do Shortcuts só oferecem JSON, Form e File como tipos de corpo — não há opção de texto simples. File com uma variável de texto é como se envia um corpo em bruto, e o cabeçalho Content-Type acima é o que faz o servidor lê-lo como texto.

Dá-lhe um gatilho

Abre o painel de detalhes ⓘ e escolhe o que realmente vais usar:

macOS — enviar o texto selecionado

O que vale a pena. Seleciona uma frase em qualquer lado, clica com o botão direito, e vira tarefa.

  1. Duplica o atalho anterior e chama à cópia algo como Send to okdone.
  2. Apaga a ação Ask for Input.
  3. Em Get Contents of URL, troca a variável do corpo por Shortcut Input.
  4. No painel de detalhes, marca Use as Quick Action e Services Menu e põe em Text a linha de entrada no topo do editor.

Passa a aparecer em Serviços no menu do botão direito de qualquer app com texto selecionável.

iPhone e iPad

As mesmas ações e pela mesma ordem — a app Atalhos é a do telemóvel. Duas coisas extra que compensam:

Formatar o texto

O que enviares recebe o mesmo tratamento do que escreves na app:

Chase the migration rollback #work !p1
Marcel said the ledger needs re-pointing first

A partir de um script ou do terminal

O texto simples precisa que digas o tipo de conteúdo — o curl -d envia form-encoded por omissão, e o servidor lê isso como um formulário e não como a tua tarefa.

curl -X POST "$CAPTURE_URL" \
  -H 'content-type: text/plain' \
  -d 'Renew the TLS cert #infra !p2'

JSON quando quiseres uma data de entrega:

curl -X POST "$CAPTURE_URL" \
  -H 'content-type: application/json' \
  -d '{"title":"Renew the TLS cert","tags":"infra","due":"2026-08-14T09:00:00Z","priority":2}'

Também funciona subject / text / from em form-encoded — é o formato que os serviços de mail de entrada publicam, por isso podes apontar um ao teu link de captura sem escrever código nenhum.

Onde tudo aterra

Definições → Captura tem dois destinos, definidos em separado: um para o endpoint de captura e outro para o teu endereço de email. Aponta-os a listas diferentes se quiseres triar o mail à parte do que envias tu. Se apagares a lista de destino, o que chegar cai na Caixa de entrada em vez de desaparecer.

Configurar a captura — okdone