Erste Schritte
API-Schlüssel
Auf dieser Seite
Der Tab Schlüssel einer Website enthält die Schlüssel, mit denen sich Ihr Shop und andere Werkzeuge mit Searcio verbinden. Das WordPress-Plugin richtet sie beim Verbinden meist selbst ein, Sie brauchen sie also nur selten. Hier erneuern Sie die Schlüssel auch und entfernen die Website.
Sie öffnen den Tab unter Websites > Fjellwerk Outdoor > Schlüssel.
Die Schlüssel im Überblick
Der Tab zeigt drei Schlüssel und das Write-Secret. Sie gelten nur für diese eine Website.
| Schlüssel | Wofür | Geheim halten? |
|---|---|---|
| Search-Key | Das Suchfeld auf Ihrer Website sucht damit bei Searcio. Er beginnt mit sk_. |
Nein. Der Browser Ihrer Besucher verwendet ihn, deshalb darf er öffentlich sein. Inhalte oder Einstellungen lassen sich damit nicht ändern. |
| Write-Key | Ihr Shop sendet damit seine Produkte und anderen Inhalte an Searcio. Er beginnt mit wk_. |
Ja. Er gehört nur auf Ihren Server, etwa in das WordPress-Plugin. |
| Write-Secret | Das Passwort zum Write-Key. Searcio nimmt Inhalte nur mit beiden zusammen an. | Ja, wie ein Passwort. |
| Read-Key (MCP) | Zum Verbinden eines KI-Werkzeugs. Es kann Ihre Statistiken lesen und Ihre Produkte durchsuchen, aber nichts ändern. Er beginnt mit rk_. |
Ja. Wer ihn hat, kann Ihre Suchstatistik lesen. |
Um einen Schlüssel zu kopieren, klicken Sie auf die Schaltfläche mit dem Kopiersymbol rechts neben ihm. Ein Häkchen bestätigt, dass er in der Zwischenablage liegt.
Wofür Sie die Schlüssel eintragen:
- WordPress-Plugin: den Search-Key, den Write-Key und das Write-Secret, im Tab Verbindung des Plugins. Siehe Website an den Shop anbinden.
- Eigene Software: den Write-Key und das Write-Secret auf Ihrem Server, den Search-Key im Suchfeld. Siehe die Referenz der REST-API.
- KI-Werkzeug: den Read-Key. Wie Sie ein KI-Werkzeug verbinden, beschreibt die Referenz des MCP-Servers.
Das Write-Secret
Searcio bewahrt das Write-Secret nicht im Klartext auf und kann es deshalb nicht noch einmal anzeigen. Der Tab zeigt es genau einmal: direkt nachdem Sie die Website hinzugefügt oder die Schlüssel neu generiert haben. In diesem Moment ist es hervorgehoben, mit dem Hinweis, es jetzt zu kopieren.
Sobald Sie die Seite neu laden oder verlassen, steht dort nur noch (nicht mehr abrufbar). Kopieren Sie das Write-Secret deshalb sofort und tragen Sie es dort ein, wo es gebraucht wird, etwa im WordPress-Plugin.
Haben Sie das Write-Secret verloren, generieren Sie die Schlüssel neu. Dabei ändern sich alle Schlüssel der Website, nicht nur das Write-Secret.
Schlüssel neu generieren
Generieren Sie die Schlüssel neu, wenn das Write-Secret verloren gegangen ist oder wenn ein Write-Key, ein Write-Secret oder ein Read-Key in falsche Hände geraten sein könnte, etwa weil ein Mitarbeiter mit Zugang das Unternehmen verlassen hat.
- Öffnen Sie Websites > Fjellwerk Outdoor > Schlüssel.
- Klicken Sie auf Schlüssel neu generieren.
- Lesen Sie den Dialog API-Schlüssel dieser Seite erneuern? und klicken Sie auf Schlüssel erneuern.
- Kopieren Sie die neuen Schlüssel. Das neue Write-Secret ist hervorgehoben und wird nur dieses eine Mal angezeigt.
- Tragen Sie die neuen Schlüssel überall ein, wo die alten verwendet wurden.
Neu generieren können Inhaber, Manager und Bearbeiter, siehe Rollen und Rechte.
Was beim Erneuern passiert
Der Search-Key, der Write-Key, das Write-Secret und der Read-Key werden alle zugleich ersetzt, und die bisherigen werden sofort ungültig. Bis Sie die neuen Schlüssel eingetragen haben:
- liefert Searcio dem Suchfeld auf Ihrer Website keine Ergebnisse mehr, weil der alte Search-Key nicht mehr gilt;
- nimmt Searcio keine Inhalte mehr von Ihrem Shop an, sodass neue und geänderte Produkte nicht in der Suche erscheinen;
- verliert ein KI-Werkzeug mit dem alten Read-Key seinen Zugang.
Die Inhalte im Suchindex und alle Einstellungen der Website bleiben dabei erhalten.
Im WordPress-Plugin tragen Sie die neuen Schlüssel so ein:
- Öffnen Sie im WordPress-Adminbereich Searcio > Verbindung.
- Öffnen Sie Erweitert: Schlüssel manuell eingeben / erneuern und geben Sie den neuen Search Key, Write Key und das neue Write Secret ein.
- Klicken Sie auf Verbindung speichern und dann auf Verbindung testen.
Halten Sie das WordPress-Plugin schon geöffnet, bevor Sie die Schlüssel neu generieren. Dann ist die Suche auf Ihrer Website nur so lange unterbrochen, wie das Eintragen dauert.
Website entfernen
Am Ende des Tabs steht der Bereich Seite entfernen. In den Papierkorb verschiebt die Website nach einer Bestätigung in den Papierkorb. Der Suchindex bleibt dabei erhalten, bis Sie die Website endgültig löschen.
Was im Papierkorb mit der Website geschieht und wie Sie sie wiederherstellen, steht unter Website entfernen.