← Torna a la pàgina principal

Configurar la captura

El punt de captura converteix qualsevol petició HTTP en una tasca. Una Drecera al mòbil, una regla al client de correu, una línia en un script — qualsevol cosa que pugui fer un POST.

Aconsegueix el teu enllaç

A okdone, obre Configuració → Captura i prem Crea un enllaç de captura. Obtindràs una adreça com ara https://okdone.app/api/capture/<token>.

Aquest enllaç és la credencial. Qui el tingui pot apuntar tasques al teu compte, així que tracta’l com una contrasenya. Si s’escapa, prem Renova l’enllaç i l’antic deixa de funcionar immediatament.

macOS — demana una tasca

La del dia a dia: una drecera de teclat que obre un quadre, agafa una línia de text, l’apunta i desapareix.

  1. Obre Dreceres → Arxiu → Drecera nova. Anomena-la Afegeix a okdone.
  2. Busca a la llista d’accions Demana una entrada i arrossega-la. Deixa el tipus com a Text, posa Tasca nova a Indicació i deixa Resposta per defecte buida — el que hi posis omplirà el quadre i l’hauràs d’esborrar cada vegada. Marca Permet diverses línies.
  3. Afegeix Obtén el contingut de l’URL a sota i enganxa-hi el teu enllaç de captura al camp URL.
  4. Fes clic a Mostra’n més per desplegar les opcions i posa Mètode a POST.
  5. A Capçaleres, afegeix una fila: clau Content-Type, valor text/plain.
  6. Posa Cos de la petició a Fitxer. Al camp que apareix, tria la variable màgica de la primera acció — segons la versió del macOS surt com a Demana una entrada o Entrada proporcionada.
  7. Prem ▶ per provar-ho. La primera vegada demana permís per contactar amb el servidor; dóna-l’hi.

Les versions recents de Dreceres només ofereixen JSON, Formulari i Fitxer com a tipus de cos — no hi ha opció de Text pla. Fitxer amb una variable de text és com s’envia un cos cru, i la capçalera Content-Type de dalt és el que fa que el servidor el llegeixi com a text.

Dóna-li un disparador

Obre el plafó de detalls ⓘ i tria el que realment faràs servir:

macOS — apunta el text seleccionat

La que s’ho val de debò. Selecciona una frase on sigui, fes clic dret, i es converteix en una tasca.

  1. Duplica la drecera de dalt i anomena la còpia Envia a okdone.
  2. Elimina l’acció Demana una entrada.
  3. A Obtén el contingut de l’URL, canvia la variable del cos per Entrada de la drecera.
  4. Al plafó de detalls, marca Fes servir com a acció ràpida i Menú de serveis, i posa a Text la fila de dalt de l’editor que rep l’entrada.

Ara surt a Serveis al menú del clic dret de qualsevol app amb text seleccionable.

iPhone i iPad

Les mateixes accions i el mateix ordre — l’app Dreceres és la del mòbil. Dues coses més que val la pena fer:

Donar format al text

El que enviïs rep el mateix tracte que si ho escrivissis a l’app:

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

Des d’un script o el terminal

El text pla necessita que el tipus de contingut sigui explícit — curl -d envia dades de formulari per defecte, i el servidor ho llegeix com un formulari i no com la teva tasca.

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

JSON quan vulguis posar-hi data de venciment:

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é funciona subject / text / from codificat com a formulari — és la forma que envien els serveis de correu entrant, així que en pots apuntar un al teu enllaç de captura sense escriure gens de codi.

On va a parar tot

Configuració → Captura té dos destins, independents: un per al punt de captura i un altre per a la teva adreça de correu. Apunta’ls a llistes diferents si vols triar el correu a part del que apuntes tu. Si elimines la llista de destí, el que arribi va a la Safata en comptes de desaparèixer.

Configurar la captura — okdone