Web moderno (Content API e webhook)
Pubblica su qualsiasi sito non WordPress: recupera gli articoli con una chiave API (PULL) o ricevili sul tuo webhook (PUSH).
«Integrazione Web Moderna» serve per qualsiasi sito che non usa WordPress: un sito su misura, un CMS headless, un sito statico. Ci sono due modi, a scelta. Con PULL il tuo sito recupera gli articoli da Rankfender con una chiave API. Con PUSH Rankfender invia ogni articolo al tuo webhook quando lo pubblichi. È inclusa in ogni piano.
Aprila con «Connetti» (o «Configure») sulla scheda in Impostazioni › Integrazioni. La finestra ha due schede, «PULL (API)» e «PUSH (Webhook)», ed è in inglese.
PULL: il tuo sito recupera gli articoli
Fai clic su «Generate API Key»
La chiave compare con un pulsante «Copy». La finestra ricorda di tenerla segreta e, in produzione, di usare variabili d'ambiente e rendering lato server.
Fai clic su «Test Connection»
«Connection successful! API key is valid and working.» conferma la chiave.
Copia un esempio
Usa la chiamata API diretta (curl) mostrata nella scheda: funziona così com'è e invia la chiave nell'header X-Rankfender-Key. Gli esempi Next.js, React e iframe della scheda si basano su un pacchetto SDK e uno script di incorporamento non pubblicati: chiama invece l'API direttamente dal tuo framework.
Parametri e risposte: Riferimento della Content API e Autenticazione.
PUSH: Rankfender invia ogni articolo
| Campo | Cosa inserire |
|---|---|
| Webhook URL | L'indirizzo a cui Rankfender invia gli articoli in POST, come https://your-website.com/api/rankfender/publish. |
| «Authentication Method» | None, API Key (header X-API-Key), Bearer Token, Basic Auth o Webhook Secret (header X-Webhook-Secret). |
| La credenziale | La chiave, il token o il segreto di quel metodo. Nascosta mentre scrivi. |
| «Custom Headers (Optional)» | Header HTTP aggiuntivi in JSON, come {"X-Custom-Header": "value"}. |
| «Enable Webhook» | Quando è attivo, ogni articolo pubblicato viene inviato al tuo webhook. |
Fai clic su «Save Configuration», poi su «Test Webhook»: Rankfender invia un articolo di prova intitolato «Rankfender Webhook Test» con l'header X-Rankfender-Test: true. Qualsiasi risposta 2xx supera il test. Dopo invii reali, «Last successful call:» mostra la data.
Cosa riceve il tuo indirizzo
- Un POST con corpo JSON e gli header X-Rankfender-Event: article.published e X-Rankfender-Domain.
- L'articolo: title, slug, content (HTML), excerpt, meta_description, meta_title, keywords, featured_image, author, published_at, più seo_data e custom_data.
- Il tuo indirizzo deve rispondere tra 200 e 299. Può restituire {"url": "..."} con l'indirizzo della pagina pubblicata.
- Rankfender non salva nulla dalla tua parte: registra i dati nel tuo database o CMS.
Elenco completo di campi e header: Webhook.
Nota
Quali articoli vengono pubblicati, e quando, si decide in Contenuti: Pubblicazione e pilota automatico.