Web moderna (API de contenido y webhook)
Publica en cualquier sitio que no sea WordPress: obtén los artículos con una clave de API (PULL) o recíbelos en tu webhook (PUSH).
«Integración Web Moderna» sirve para cualquier sitio que no use WordPress: un sitio a medida, un CMS headless, un sitio estático. Hay dos modos, a elegir. Con PULL, tu sitio obtiene los artículos de Rankfender con una clave de API. Con PUSH, Rankfender envía cada artículo a tu webhook al publicarlo. Está en todos los planes.
Ábrela con «Conectar» (o «Configure») en la tarjeta de Configuración › Integraciones. La ventana tiene dos pestañas, «PULL (API)» y «PUSH (Webhook)», y está en inglés.
PULL: tu sitio obtiene los artículos
Haz clic en «Generate API Key»
La clave aparece con un botón «Copy». La ventana recuerda que la guardes en secreto y que en producción uses variables de entorno y renderizado en el servidor.
Haz clic en «Test Connection»
«Connection successful! API key is valid and working.» confirma la clave.
Copia un ejemplo
Usa la llamada directa a la API (curl) que muestra la tarjeta: funciona tal cual y envía la clave en el encabezado X-Rankfender-Key. Los ejemplos de Next.js, React e iframe de la tarjeta dependen de un paquete SDK y un script de inserción que no están publicados, así que llama a la API directamente desde tu framework.
Parámetros y respuestas: Referencia de la API de contenido y Autenticación.
PUSH: Rankfender envía cada artículo
| Campo | Qué escribir |
|---|---|
| Webhook URL | La dirección a la que Rankfender envía los artículos por POST, como https://your-website.com/api/rankfender/publish. |
| «Authentication Method» | None, API Key (cabecera X-API-Key), Bearer Token, Basic Auth o Webhook Secret (cabecera X-Webhook-Secret). |
| La credencial | La clave, el token o el secreto de ese método. Se oculta al escribir. |
| «Custom Headers (Optional)» | Cabeceras HTTP adicionales en JSON, como {"X-Custom-Header": "value"}. |
| «Enable Webhook» | Al activarlo, cada artículo publicado se envía a tu webhook. |
Haz clic en «Save Configuration» y luego en «Test Webhook»: Rankfender envía un artículo de prueba titulado «Rankfender Webhook Test» con la cabecera X-Rankfender-Test: true. Cualquier respuesta 2xx lo aprueba. Tras envíos reales, «Last successful call:» muestra la fecha.
Qué recibe tu dirección
- Un POST con cuerpo JSON y las cabeceras X-Rankfender-Event: article.published y X-Rankfender-Domain.
- El artículo: title, slug, content (HTML), excerpt, meta_description, meta_title, keywords, featured_image, author, published_at, además de seo_data y custom_data.
- Tu dirección debe responder entre 200 y 299. Puede devolver {"url": "..."} con la dirección de la página publicada.
- Rankfender no guarda nada en tu lado: guarda los datos en tu propia base de datos o CMS.
Lista completa de campos y cabeceras: Webhooks.
Nota
Qué artículos se publican, y cuándo, se decide en Contenido: Publicación y piloto automático.