La tua chiave API
Crea la chiave API di un progetto sulla scheda Integrazione Web Moderna, inviala nell'header X-Rankfender-Key e sostituiscila in sicurezza.
L'API dei contenuti capisce di quale progetto si tratta dalla chiave API. Ogni progetto ha la sua chiave, creata sulla sua scheda «Integrazione Web Moderna». La chiave legge solo gli articoli pubblicati di quel progetto.
Creare la chiave
Apri la scheda
Impostazioni › Integrazioni, poi «Connetti» (o «Configure») su «Integrazione Web Moderna». Resta nella scheda «PULL (API)».
Clicca «Generate API Key»
La chiave compare con un pulsante «Copy». Inizia con rfk_ seguito da 64 lettere e cifre.
Clicca «Test Connection»
«Connection successful! API key is valid and working.» la conferma.
Inviala a ogni richiesta
Metti la chiave nell'header X-Rankfender-Key. Non c'è un altro modo di passarla.
curl "https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api?limit=1" \
-H "X-Rankfender-Key: rfk_your_key"| Risposta | Significato |
|---|---|
| 401 «API key required. Pass via X-Rankfender-Key header.» | Manca l'header. |
| 401 «Invalid API key» | La chiave non corrisponde a nessun progetto, per esempio dopo che è stata sostituita. |
Sostituire una chiave
Clicca di nuovo «Generate API Key». La nuova chiave sostituisce subito la vecchia: ogni sito che usa ancora quella vecchia riceve «Invalid API key» finché non lo aggiorni.
Importante
Chiunque abbia la chiave può leggere gli articoli pubblicati del progetto. Tienila sul tuo server, in una variabile d'ambiente, e chiama l'API da codice lato server, non dal browser.
Impostazioni account › «Chiavi API» mostra «La gestione delle chiavi API sarà disponibile presto»: le chiavi si gestiscono per progetto, come sopra. Poi: Riferimento dell'API dei contenuti.