Wenn Sie einen Schlüssel brauchen
Der Buy-Button funktioniert ganz ohne Schlüssel — er spricht mit öffentlichen, projektbezogenen Endpunkten. Ein Schlüssel ist für den anderen Weg: Aufrufe, die Sie von Ihrem eigenen Server aus tätigen, wo Sie einen Checkout erstellen oder den Status einer Transaktion im Code lesen. Schlüssel befinden sich unter dem Reiter API-Schlüssel Ihres Projekts.
Einen Schlüssel erstellen
Klicken Sie auf Schlüssel erstellen, geben Sie ihm einen Namen, den Sie später erkennen werden — normalerweise der Ort, an dem er läuft, wie „Production server" — und klicken Sie auf Schlüssel generieren. Der Name ist nur ein Label für Sie; er ändert nicht, was der Schlüssel kann (ein Schlüssel ist auf dieses Projekt bezogen).
Kopieren Sie ihn einmal
Der Schlüssel wird einmal angezeigt, direkt nach dem Generieren. Er beginnt mit cmk_. Kopieren Sie ihn jetzt und speichern Sie ihn sicher — wir speichern nur einen Hash, daher können wir ihn dir nicht nochmal zeigen. Verlieren Sie ihn und Sie erstellen einfach einen neuen und löschen den alten.
Behandeln Sie den Schlüssel wie ein Passwort. Verwenden Sie ihn nur von Server-seitigem Code, senden Sie ihn im Header Authorization als Bearer-Token, und geben Sie ihn niemals auf einer Webseite, in einem öffentlichen Repository oder in etwas ein, das an einen Käuferbrowser versendet wird. Jeder mit dem Schlüssel kann für Ihr Projekt handeln.
Verwenden, auflisten und widerrufen
Gespeicherte Schlüssel werden nach Name, verdecktem Präfix und Erstellungsdatum aufgelistet. Sie sehen den vollständigen Schlüssel nie wieder — das Präfix reicht gerade aus, um sie zu unterscheiden. Das Papierkorb-Symbol widerruft einen Schlüssel sofort: jeder Code, der ihn immer noch verwendet, beginnt abgelehnt zu werden, daher drehen Sie, indem Sie zuerst den neuen Schlüssel erstellen, ihn einsetzen, dann den alten löschen.
Für das, was Sie mit dem Schlüssel aufrufen können — Erstellen eines Checkouts von Ihrem eigenen Code, Verarbeiten von Ereignissen und Polling von Status — siehe Verwenden der API.