der workspace-schlüssel
Deinen Workspace-Schlüssel bekommen, damit anmelden, austauschen, zurückholen, und deine Domain bestätigen, um die Grenzen aufzuheben.
Ein Workspace gehört zu einer Domain, die du kontrollierst. Sein Schlüssel, der mit fw_ beginnt, ist die einzige Zugangsberechtigung: Web-App, API, MCP und das Kommandozeilen-Tool nehmen ihn alle.
Einen Schlüssel bekommen
Öffne in der Web-App app.frwrd.to und gib unter "Workspace anlegen" deine Domain ein, zum Beispiel acme.com. Die nächste Seite hat eine einzige Aufgabe: Speichere deinen Schlüssel. Kopiere ihn oder lade ihn als Datei herunter und geh dann weiter zu deinem Workspace. Oder ruf die API auf:
curl -X POST https://api.frwrd.to/v1/workspaces -H "Content-Type: application/json" -d '{"domain":"acme.com"}'
Die Antwort enthält den Schlüssel und einen DNS-Eintrag zum Veröffentlichen. Der Schlüssel wird nur einmal angezeigt. frwrd.to speichert nur einen Hash davon und kann ihn nicht noch einmal zeigen, speichere ihn also sofort. Workspaces anzulegen ist auf 5 pro Minute und Adresse begrenzt.
So nutzt du ihn
- Web-App: Gib den Schlüssel unter "Mit deinem Schlüssel anmelden" ein. Der Browser behält höchstens 30 Tage lang eine Sitzung, nie den Schlüssel.
- API: Sende den Header
Authorization: Bearer fw_.... - MCP: derselbe Header, siehe die MCP-Hilfe.
- Kommandozeilen-Tool: Setze
FRWRD_KEYin der Umgebung.
Schreib den Schlüssel nie in eine URL, einen Link oder eine Seite: Adressen landen in Logs, im Browserverlauf und in geteilten Screenshots, und Seiten sind öffentlich.
Domain bestätigen
Solange die Domain nicht bestätigt ist, hält ein Workspace höchstens 50 Links und 3 Seiten und läuft 31 Tage nach dem Anlegen ab. Die Bestätigung hebt die Grenzen auf 10.000 Links und 50 Seiten an, entfernt das Ablaufdatum und schaltet ein Handle (/@acme), eigene Link-Hashes und eigene Seiten-Domains frei.
Die Bestätigung ist freiwillig, bis der Workspace abläuft. In der Web-App zeigt die Übersicht so lange ein Banner, bis die Domain bestätigt ist (du kannst es für eine Woche ausblenden); der Knopf "Domain nachweisen" im Banner oder derselbe Link in den Einstellungen öffnet eine Seite mit Name und Wert des Eintrags, jeweils mit Kopieren-Knopf, den Schritten und dem Knopf "Jetzt prüfen". Von Hand veröffentlichst du einen DNS-TXT-Eintrag bei _frwrd.acme.com mit dem Wert, den das Anlegen des Workspace geliefert hat. Du kannst ihn jederzeit mit GET /v1/workspace wieder abrufen. Sobald der Eintrag sichtbar ist, drückst du auf "Jetzt prüfen" oder rufst auf:
curl -X POST https://api.frwrd.to/v1/workspace/verify -H "Authorization: Bearer $FRWRD_KEY"
DNS braucht manchmal eine Weile. Ist der Eintrag noch nicht sichtbar, sagt das die Antwort und wiederholt ihn, und du kannst es noch einmal versuchen.
Den Schlüssel austauschen
Wenn ein Schlüssel in falsche Hände geraten sein könnte, stell einen neuen aus. Der alte Schlüssel funktioniert sofort nicht mehr, und Web-Sitzungen enden:
curl -X POST https://api.frwrd.to/v1/workspace/rotate-key -H "Authorization: Bearer $FRWRD_KEY"
Auch der neue Schlüssel wird nur einmal angezeigt. Der Austausch entfernt auch die Wiederherstellungs-E-Mail, denn wer den alten Schlüssel hatte, könnte sie gesetzt haben: Richte deine wieder ein.
Schlüssel verloren
Du holst einen Workspace zurück, indem du beweist, dass du seine Domain kontrollierst, in zwei Schritten und ohne Schlüssel.
POST /v1/workspaces/recovermit{"domain":"acme.com"}liefert einen TXT-Eintrag und einrecovery_secret. Noch ändert sich nichts, und der alte Schlüssel funktioniert weiter.- Veröffentliche den Eintrag bei
_frwrd.acme.comund ruf dannPOST /v1/workspaces/recover/confirmmit der Domain und demrecovery_secretauf. Die Antwort enthält einen neuen Schlüssel, und der alte ist tot.
curl -X POST https://api.frwrd.to/v1/workspaces/recover -H "Content-Type: application/json" -d '{"domain":"acme.com"}' curl -X POST https://api.frwrd.to/v1/workspaces/recover/confirm -H "Content-Type: application/json" -d '{"domain":"acme.com","recovery_secret":"..."}'
Ein Workspace, der nie bestätigt wurde, verliert bei der Rückholung seine Links, denn ihn hätte jeder anlegen können. Das Kommandozeilen-Tool kennt beide Schritte auch: frwrd workspace recover acme.com, dann frwrd workspace recover-confirm acme.com.
Ohne bestätigte Domain: die Wiederherstellungs-E-Mail
Richte eine Wiederherstellungs-E-Mail ein, solange du den Schlüssel noch hast: in der Web-App unter Einstellungen, Konto, „Wiederherstellungs-E-Mail“, oder mit frwrd workspace recovery-email du@example.com (MCP set_recovery_email, API PUT /v1/workspace/recovery-email). Wir schicken einen Code; gibst du ihn ein, ist die Adresse bestätigt. Gespeichert wird nur ein Fingerabdruck der Adresse, nie die Adresse selbst.
Schlüssel verloren: auf der Anmeldeseite „Schlüssel verloren?“, Adresse eingeben, Code aus der Mail eingeben. Du bist angemeldet und bekommst einen neuen Schlüssel, einmal angezeigt; der alte funktioniert nicht mehr. In der Kommandozeile: frwrd workspace recover-email du@example.com, dann frwrd workspace recover-email-confirm du@example.com mit dem Code in FRWRD_RECOVERY_CODE. Ein Workspace mit bestätigter Domain wird über die Domain wiederhergestellt.
Den Workspace löschen
Du kannst einen Workspace selbst löschen: in der Web-App (der Abschnitt "Workspace löschen" ganz unten in den Einstellungen führt zu einer Bestätigungsseite, auf der du die Domain eintippst), mit frwrd workspace delete --confirm acme.com, über MCP mit delete_workspace oder mit der API:
curl -X DELETE https://api.frwrd.to/v1/workspace -H "Authorization: Bearer $FRWRD_KEY" -H "Content-Type: application/json" -d '{"confirm":"acme.com"}'
Einen Workspace zu löschen stoppt seinen Schlüssel und nimmt seine Seiten sofort offline; nach 7 Tagen werden die Seiten und Einstellungen gelöscht. Kurzlinks funktionieren weiter. Wer die Domain innerhalb von 7 Tagen erneut nachweist (die Rückholung des Schlüssels, oben), bekommt alles zurück; bis zu 60 Tage danach die Links. Nach 60 Tagen ist die Domain frei und die Links funktionieren ohne Besitzer weiter. Browser können Kopien einer Seite, ihres QR-Codes und der Bilder bis zu einer Stunde nach dem Löschen behalten.
Sofort funktioniert der Schlüssel nicht mehr, du bist aus der Web-App abgemeldet, und jede Adresse deiner Seiten antwortet mit "nicht gefunden", auch auf deiner eigenen Domain. Deine Kurzlinks und gedruckten QR-Codes leiten weiter und zählen Klicks, auch die Links, die deine Seiten angelegt haben. Nach 7 Tagen werden die Seiten, ihre Versionen, deine eigenen Domains, die UTM-Vorgaben und die Standardsprache gelöscht, und das Handle bleibt reserviert, damit es niemand anderes nimmt. 60 Tage lang bleibt die Domain beim Workspace: Um sie wieder zu nutzen, hol den Schlüssel zurück. Danach ist sie frei und lässt sich als neuer, leerer Workspace registrieren; deine alten Kurzlinks leiten weiter, ohne Besitzer. Backups halten die Daten noch bis zu 35 Tage und dienen nur dazu, den Dienst nach einem Ausfall wiederherzustellen.
