Kiedy potrzebujesz klucza
Przycisk kupna działa bez żadnego klucza — rozmawia z publicznymi, punktami końcowymi o zasięgu projektu. Klucz jest na inną ścieżkę: wywołania, które wykonujesz z Twojego własnego serwera, gdzie tworzysz kasę lub czytasz status transakcji w kodzie. Klucze znajdują się pod zakładką Klucze API Twojego projektu.
Utwórz klucz
Kliknij Utwórz klucz, podaj mu nazwę, którą rozpoznasz później — zwykle miejsce, w którym się uruchamia, na przykład „Serwer produkcji" — i kliknij Wygeneruj klucz. Nazwa jest tylko etykietą dla ciebie; nie zmienia tego, co może zrobić klucz (klucz jest objęty zakresem tego projektu).
Skopiuj go raz
Klucz jest wyświetlany raz, zaraz po jego wygenerowaniu. Zaczyna się od cmk_. Skopiuj go teraz i przechowuj w bezpiecznym miejscu — przechowujemy tylko hash, więc nie możemy go pokazać ponownie. Zgub go i po prostu utwórz nowy i usuń stary.
Traktuj klucz jak hasło. Używaj go tylko z kodu po stronie serwera, wysyłaj go w nagłówku Authorization jako token nośnika i nigdy nie umieszczaj go na stronie internetowej, w publicznym repozytorium ani niczego, co wysyłasz do przeglądarki kupującego. Każdy z kluczem może działać za Twój projekt.
Używaj, wymieniaj i odwoływaj
Zapisane klucze są wymienione według nazwy, maskowanego prefiksu i daty utworzenia. Nigdy więcej nie zobaczysz pełnego klucza — prefiks wystarczy, aby je rozróżnić. Ikona kosza natychmiast odwołuje klucz: dowolny kod, który go nadal używa, zaczyna być odrzucany, więc rotuj, tworząc nowy klucz najpierw, wdrażając go, a następnie usuwając stary.
Aby dowiedzieć się, co możesz wywoływać za pomocą klucza — tworzenie kasy z Twojego kodu, obsługę zdarzeń i sondowanie statusu — patrz Korzystanie z API.