Autenticación

Cada solicitud a la API de RankLadder se autentica con una clave de API por negocio enviada en el encabezado Authorization.

URL base

https://app.rankladder.app/api/v1

Obtener una clave de API

1. En RankLadder, abre la página Conexiones.
2. Baja hasta la sección Automatización y elige la tarjeta de Zapier o Make.
3. Haz clic en Generar clave de API.
4. Copia la clave de inmediato. Se muestra exactamente una vez. RankLadder guarda solo un hash de la clave, así que no puede mostrarse de nuevo.

Las claves tienen esta forma:

rl_zapier_9f2c4e...   (generada desde la tarjeta de Zapier)
rl_make_7a1b3d...     (generada desde la tarjeta de Make)

Cada tarjeta emite una clave distinta, una por plataforma. Hacer clic en Generar nueva clave rota la clave: la anterior deja de funcionar al instante.

La API de automatización está incluida en los planes Pro y Scale. El periodo de prueba también la incluye.

Enviar la clave

Pasa la clave como token Bearer en cada solicitud:

curl https://app.rankladder.app/api/v1/hooks \
  -H "Authorization: Bearer rl_zapier_YOUR_KEY"

Verificar una clave

GET /api/v1/me

Devuelve a qué negocio pertenece la clave. Útil para confirmar que una clave es válida, o para etiquetar una conexión en una herramienta como Zapier o Make.

{ "business_name": "Sam Alvarez Plumbing" }

Revocar una clave

Haz clic en Revocar en la tarjeta para eliminar la clave. Al revocarla también se eliminan todas las suscripciones de webhook creadas con esa clave, así que cualquier flujo que aún la use deja de recibir eventos y su siguiente solicitud falla.

Errores

Una clave ausente, mal formada, rotada o revocada devuelve:

HTTP 401
{ "error": "unauthorized" }