Claves de API y la API pública

La API pública permite que otros sistemas trabajen en tu espacio de trabajo sin iniciar sesión como una persona. Un flujo de n8n puede crear una tarea cuando termina una grabación, un script puede traer las horas del mes pasado y un formulario puede registrar lo que el cliente aprobó por WhatsApp.

Es la otra mitad de los webhooks: los webhooks avisan a tus herramientas que algo pasó en RecReview, y la API permite que tus herramientas actúen en RecReview.

Antes de empezar: la API necesita una suscripción Studio paga; no Creator, no Pro y no la prueba gratuita. Solo los propietarios y administradores del espacio de trabajo pueden crear claves.

Crea una clave

1. Haz clic en tu avatar, arriba a la derecha, y elige Configuración del espacio de trabajo.
2. En Avanzado, abre la pestaña API.
3. Haz clic en Nueva clave.
4. Dale un Nombre, como n8n — grabaciones. Este nombre aparece como autor de todo lo que hace la clave.
5. En Permisos, marca solo lo que la automatización necesita.
6. En Vence, elige Nunca, En 30 días, En 90 días o En 1 año.
7. Haz clic en Crear clave.
8. Copia la clave que aparece en Copia tu clave ahora y guárdala en tu herramienta de automatización. Luego haz clic en Ya la guardé.

Atención: Esta es la única vez que se muestra la clave completa. RecReview no puede mostrártela de nuevo. Si la pierdes, crea una clave nueva y revoca la anterior.

Un espacio de trabajo puede tener hasta 20 claves activas al mismo tiempo. Las claves revocadas y vencidas no cuentan.

Permisos

Una clave solo puede hacer lo que marques. Todo lo demás se rechaza.

No es posible cambiar el cliente o el proyecto de una tarea por la API: eso cambiaría el código del video y el portal donde aparece la tarea.

Usa la clave

Cada solicitud va a https://rec.review/api/v1 y lleva la clave en el encabezado Authorization:

Authorization: Bearer rr_live_...

Los cuerpos de solicitud y respuesta son JSON. Los campos que la API no conoce se rechazan, así un error de tipeo no se ignora en silencio.

Para comprobar que la clave funciona, llama a GET /me. Responde con el nombre de la clave, sus permisos y el espacio de trabajo al que pertenece. Cada clave pertenece a un espacio de trabajo, así que nunca pasas un id de espacio de trabajo.

Ejemplo: crear una tarea

curl -X POST https://rec.review/api/v1/tasks \
  -H "Authorization: Bearer $RECREVIEW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: recording-1234" \
  -d '{
    "title": "Edición — Clase 3",
    "projectId": "<project id>",
    "dueDate": "2026-10-30T15:00:00.000Z",
    "attachments": [
      { "type": "link", "name": "Transcripción", "url": "https://drive.google.com/..." }
    ]
  }'

La tarea pasa por las mismas validaciones y las mismas automatizaciones de Tarea creada que una creada en la app. Envía "kind": "gallery" para crear una tarea de galería de fotos.

El encabezado Idempotency-Key es opcional, pero vale la pena enviarlo. Básalo en el evento que disparó la automatización. Si la misma solicitud llega dos veces, RecReview devuelve la tarea que ya creó en lugar de duplicarla.

Otras llamadas útiles

Registrar un veredicto tiene el mismo efecto que registrarlo desde la pantalla de revisión: libera el bloqueo del cliente, ejecuta tus automatizaciones y, si es una aprobación, envía el correo de entrega final y el webhook video.delivery_approved. Solo funciona en la versión más reciente.

Mantén la clave fuera de la vista

En n8n, guarda la clave como una credencial Header Auth (nombre Authorization, valor Bearer rr_live_...) y selecciona esa credencial en el nodo HTTP Request. No pegues la clave directamente en un nodo o una expresión: se filtraría en los flujos exportados y en el historial de ejecuciones.

Límites

• 120 solicitudes por minuto por clave.
• 2000 tareas creadas por la API por espacio de trabajo cada 24 horas.
• Demasiados intentos fallidos de autenticación desde la misma dirección se bloquean por unos minutos.

Superar un límite devuelve un error 429. Espera e inténtalo de nuevo.

Lo que deja la clave

Todo lo que hace una clave queda firmado con su nombre. En el registro de actividad de una tarea, el autor aparece como el nombre de la clave seguido de (API), por ejemplo n8n — grabaciones (API), para que cualquiera del equipo sepa qué vino de una automatización.

La pestaña API lista cada clave con sus permisos, quién la creó, cuándo fue su Último uso y cuándo vence.

Cuando una clave deja de funcionar

• Revocada. Haz clic en Revocar en la clave y confirma con Revocar clave. Las automatizaciones que la usan se detienen de inmediato. No se puede deshacer.
• Vencida. Pasó la fecha de vencimiento que elegiste.
• Quien la creó dejó de ser administrador. Una clave solo funciona mientras la persona que la creó siga siendo propietaria o administradora del espacio de trabajo. Si se la quita, archiva, suspende o cambia a otro rol, la clave aparece como Inactiva. Un administrador tiene que crear una nueva.
• Cambió el plan. Si el espacio de trabajo deja Studio, o la suscripción se cancela, queda impaga o se pausa, todas las claves dejan de funcionar hasta que vuelva la suscripción. Un pago atrasado que todavía se está reintentando no detiene las claves.

Las solicitudes fallidas devuelven un código de error, como api_key_revoked, api_key_expired, api_key_creator_inactive, insufficient_scope o plan_required, para que tu automatización sepa en qué caso cayó.