Ir al contenido

↑↓ navegar ↵ abrir Ctrl↵ nueva pestaña esc cerrar

Esta página es la referencia técnica de todos los mecanismos de autenticación de Rapid.

Usa Basic Auth con client_id como usuario y client_secret como contraseña.

Authorization: Basic base64(client_id:client_secret)

Endpoints que usan este método:

CredencialDescripción
client_idID de tu empresa (generado en el panel)
client_secretClave secreta (generada en el panel, trátala como una contraseña)
Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ=

Donde el valor base64 se decodifica como client_id:client_secret.

  • Usa siempre HTTPS
  • No incluyas el client_secret en código frontend, repositorios públicos ni logs
  • Si sospechas que se expuso, genera un client_secret nuevo y revoca el anterior en el momento (ver abajo)

Genera un secreto nuevo en Configuración › API. El client_id no cambia. El secreto anterior sigue valiendo 24 horas desde el cambio, y el panel muestra hasta cuándo. En ese plazo Rapid acepta los dos, así que puedes actualizar sistema por sistema sin interrupción:

  1. Genera el secreto nuevo en el panel y guárdalo en tu bóveda de secretos (aparece una sola vez).
  2. Actualiza cada sistema que llama a la API.
  3. Listo: el anterior deja de valer solo al final de las 24 horas. Si el cambio fue por una filtración, no esperes: haz clic en Revocar la clave anterior ahora y deja de valer al instante.

Generar otro secreto dentro de las 24 horas descarta el anterior: junto con el nuevo, solo sigue valiendo el que estaba vigente hasta ese segundo cambio.


En el formato v2, Rapid firma cada webhook con HMAC-SHA256 y envía la firma y el timestamp en los headers:

X-Webhook-Signature: sha256=<hmac_hex>
X-Webhook-Timestamp: 1790000000

El contenido firmado no es solo el cuerpo: es ${X-Webhook-Timestamp}.${cuerpo_crudo}, el timestamp, un punto y el cuerpo exactamente como llegó. Calcular el HMAC solo sobre el cuerpo da un valor distinto y toda solicitud se rechaza. El timestamp entra en el cálculo para impedir que un POST capturado se reenvíe después (rechaza los que estén fuera de una ventana de 5 minutos).

La clave de firma (secret) la genera Rapid cuando registras el webhook y aparece una sola vez en el panel, en Configuración › Webhook. No la eliges tú y no hay forma de consultarla después: si la pierdes, genera otra en Configuración › API (la anterior deja de valer al instante).

El paso a paso de la validación, con ejemplos en Node.js, Python y PHP, está en Autenticación del webhook.

Las cuentas migradas del sistema anterior reciben los webhooks en el formato legacy, que no está firmado. En él, la autenticación son los headers que el sistema antiguo ya enviaba:

clientid: <client_id>
clientkey: <client_secret>

Estos dos headers existen solo en legacy. En v2 no se envían: clientkey es tu credencial de acceso a la API, y enviarla en cada entrega la expondría en tu endpoint y en tus logs sin necesidad, ya que en v2 la autenticación la hace la firma. Para saber en qué formato está tu cuenta, ver Payload. Después de un cambio del client_secret, el clientkey de las entregas ya sale con el secreto nuevo.