Je API-sleutel
Maak de API-sleutel van een project op de Modern Web-kaart, stuur hem mee in de header X-Rankfender-Key en vervang hem veilig.
De content-API weet aan de API-sleutel om welk project het gaat. Elk project heeft een eigen sleutel, aangemaakt op de kaart „Modern Web Integration” van dat project. De sleutel leest alleen de gepubliceerde artikelen van dat project.
De sleutel aanmaken
Open de kaart
Settings › Integraties, dan „Verbinden” (of „Configure”) bij „Modern Web Integration”. Blijf op de tab „PULL (API)”.
Klik op „Generate API Key”
De sleutel verschijnt met een knop „Copy”. Hij begint met rfk_ gevolgd door 64 letters en cijfers.
Klik op „Test Connection”
„Connection successful! API key is valid and working.” bevestigt hem.
Stuur hem bij elk verzoek mee
Zet de sleutel in de header X-Rankfender-Key. Een andere manier is er niet.
curl "https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api?limit=1" \
-H "X-Rankfender-Key: rfk_your_key"| Antwoord | Betekenis |
|---|---|
| 401 „API key required. Pass via X-Rankfender-Key header.” | De header ontbreekt. |
| 401 „Invalid API key” | De sleutel hoort bij geen enkel project, bijvoorbeeld nadat hij is vervangen. |
Een sleutel vervangen
Klik opnieuw op „Generate API Key”. De nieuwe sleutel vervangt de oude meteen: elke site die nog de oude gebruikt, krijgt „Invalid API key” tot je hem bijwerkt.
Belangrijk
Iedereen met de sleutel kan de gepubliceerde artikelen van het project lezen. Bewaar hem op je server, in een omgevingsvariabele, en roep de API aan vanuit servercode in plaats van vanuit de browser.
Accountinstellingen › „API-Sleutels” toont „API key management coming soon”: sleutels beheer je per project, zoals hierboven. Verder: Referentie van de content-API.