Ihr API-Schlüssel
Den API-Schlüssel eines Projekts auf der Karte Moderne Web-Integration erstellen, im Header X-Rankfender-Key senden und sicher ersetzen.
Die Content-API erkennt am API-Schlüssel, um welches Projekt es geht. Jedes Projekt hat einen eigenen Schlüssel, der auf seiner Karte „Moderne Web-Integration“ erstellt wird. Der Schlüssel liest nur die veröffentlichten Artikel dieses Projekts.
Schlüssel erstellen
Karte öffnen
Einstellungen › Integrationen, dann „Verbinden“ (oder „Configure“) bei „Moderne Web-Integration“. Bleiben Sie im Tab „PULL (API)“.
Auf „Generate API Key“ klicken
Der Schlüssel erscheint mit einem Knopf „Copy“. Er beginnt mit rfk_, gefolgt von 64 Buchstaben und Ziffern.
Auf „Test Connection“ klicken
„Connection successful! API key is valid and working.“ bestätigt ihn.
Bei jeder Anfrage mitsenden
Setzen Sie den Schlüssel in den Header X-Rankfender-Key. Einen anderen Weg gibt es nicht.
curl "https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api?limit=1" \
-H "X-Rankfender-Key: rfk_your_key"| Antwort | Bedeutung |
|---|---|
| 401 „API key required. Pass via X-Rankfender-Key header.“ | Der Header fehlt. |
| 401 „Invalid API key“ | Der Schlüssel passt zu keinem Projekt, zum Beispiel nachdem er ersetzt wurde. |
Schlüssel ersetzen
Klicken Sie erneut auf „Generate API Key“. Der neue Schlüssel ersetzt den alten sofort: jede Website, die noch den alten nutzt, erhält „Invalid API key“, bis Sie ihn aktualisieren.
Wichtig
Wer den Schlüssel hat, kann die veröffentlichten Artikel des Projekts lesen. Bewahren Sie ihn auf Ihrem Server in einer Umgebungsvariable auf und rufen Sie die API aus serverseitigem Code auf, nicht aus dem Browser.
Kontoeinstellungen › „API-Schlüssel“ zeigt „API-Schlüsselverwaltung kommt bald“: Schlüssel werden pro Projekt verwaltet, wie oben. Weiter: Referenz der Content-API.