← Volver a la portada

Configurar la captura

El endpoint de captura convierte cualquier petición HTTP en una tarea. Un Atajo en el móvil, una regla en el cliente de correo, una línea en un script: cualquier cosa que pueda hacer POST.

Consigue tu enlace

En okdone, abre Ajustes → Captura y pulsa Crear enlace de captura. Obtienes una dirección como https://okdone.app/api/capture/<token>.

Ese enlace es la credencial. Cualquiera que lo tenga puede meter tareas en tu cuenta, así que trátalo como una contraseña. Si se filtra, pulsa Rotar enlace y el anterior deja de funcionar al instante.

macOS — pedir una tarea

El del día a día: un atajo de teclado que abre un cuadro, recoge una línea de texto, la manda y desaparece.

  1. Abre Shortcuts → Archivo → Nuevo atajo. Llámalo Add to okdone.
  2. Busca Ask for Input en la lista de acciones y arrástralo. Deja el tipo en Text, pon Prompt en New task y deja Default Answer vacío: lo que pongas ahí rellena el cuadro y acabarás borrándolo cada vez. Marca Allow Multiple Lines.
  3. Añade Get Contents of URL debajo y pega tu enlace de captura en el campo de URL.
  4. Pulsa Show More para desplegar las opciones y pon Method en POST.
  5. En Headers, añade una fila: clave Content-Type, valor text/plain.
  6. Pon Request Body en File. En el campo que aparece, elige la variable mágica de la primera acción: según tu versión de macOS sale como Ask for Input o Provided Input.
  7. Pulsa ▶ para probarlo. La primera vez pide permiso para contactar con el servidor; concédelo.

Las versiones recientes de Shortcuts solo ofrecen JSON, Form y File como tipos de cuerpo — no hay opción de texto plano. File con una variable de texto es como se manda un cuerpo en crudo, y la cabecera Content-Type de arriba es lo que hace que el servidor lo lea como texto.

Ponle un disparador

Abre el panel de detalles ⓘ y elige el que de verdad vayas a usar:

macOS — mandar el texto seleccionado

El que se gana el sueldo. Selecciona una frase en cualquier sitio, clic derecho, y se convierte en tarea.

  1. Duplica el atajo anterior y llama a la copia algo como Send to okdone.
  2. Borra la acción Ask for Input.
  3. En Get Contents of URL, cambia la variable del cuerpo por Shortcut Input.
  4. En el panel de detalles, marca Use as Quick Action y Services Menu, y pon en Text la fila de entrada que hay arriba del editor.

Ya aparece en Servicios dentro del menú del clic derecho de cualquier app con texto seleccionable.

iPhone y iPad

Las mismas acciones y en el mismo orden — la app Atajos es la del móvil. Dos cosas extra que merece la pena hacer:

Cómo dar formato al texto

Lo que mandes recibe el mismo trato que si lo escribieras en la app:

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

Desde un script o la terminal

El texto plano necesita que indiques el tipo de contenido: curl -d manda form-encoded por defecto, y el servidor lo lee como un formulario y no como tu tarea.

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

JSON cuando quieras poner fecha 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}'

También funciona subject / text / from en form-encoded: es la forma en que publican los servicios de correo entrante, así que puedes apuntar uno a tu enlace de captura sin escribir nada de código.

Dónde acaba todo

Ajustes → Captura tiene dos destinos, que se configuran por separado: uno para el endpoint de captura y otro para tu dirección de correo. Apúntalos a listas distintas si quieres triar el correo aparte de lo que mandas tú. Si borras la lista de destino, lo que llegue cae en Entrada en vez de perderse.

Configurar la captura — okdone