Sklepy z sekretami

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Oprócz zarządzania swoimi sekretami w doświadczeniach, możesz zarządzać sekretami za pomocą interfejsu API sklepu z sekretami Open Cloud.

Zanim użyjesz interfejsu API, musisz wygenerować klucz API z systemu API secret-store lub skonfigurować swoją aplikację OAuth 2.0 z typem zakresu universe.secret. Przykłady na tej stronie używają kluczy API.

Szyfrowanie sekretów

Podczas tworzenia lub aktualizowania sekretów w Roblox, musisz zaszyfrować sekrety za pomocą LibSodium sealed box oraz publicznego klucza twojego doświadczenia, a następnie zakodować wynik w formacie base64.

Najpierw uzyskaj publiczny klucz swojego doświadczenia:


curl --location 'https://apis.roblox.com/cloud/v2/universes/{universeId}/secrets/public-key' \
--request GET \
--header 'x-api-key: <twoj-sekret-tutaj>' \

Następnie stwórz sealed box i zakoduj go w formacie base64. Poniższy przykład używa Pythona i PyNaCl. (Uruchom pip install pynacl, aby zainstalować go lokalnie).


from base64 import b64encode
from nacl import encoding, public
public_key = "Zgj4+V7vSaEZ06rXazKJUIcUnVa95tUNiwXAif/vdHo="
secret_content = "my_api_key_content"
public_key = public.PublicKey(public_key.encode("utf-8"), encoding.Base64Encoder())
sealed_box = public.SealedBox(public_key)
encrypted = sealed_box.encrypt(secret_content.encode("utf-8"))
print(b64encode(encrypted).decode("utf-8"))

Możesz następnie utworzyć lub zaktualizować sekret, używając wyniku. Ten przykład tworzy nowy sekret:


curl --location 'https://apis.roblox.com/cloud/v2/universes/6930499524/secrets' \
--request POST \
--header 'Content-Type: application/json' \
--header 'x-api-key: <twoj-sekret-tutaj>' \
--data '{
"id": "mySecret",
"secret": "fP9scJkcDk492F4c1VHZ5QS8v2qsAg7uI+NVVEw6zC0GBnj7xpi7UrNr++lCfr4wyq3ia9Uuu+Ao8HtIXz2gRxBX",
"key_id": "1200590785272263122"
}'

Po utworzeniu jednego, zobacz Użyj sekretów, aby użyć swojego sekretu w doświadczeniu.

Aktualizuj sekrety

Aby zaktualizować powyższy sekret:


curl --location 'https://apis.roblox.com/cloud/v2/universes/6930499524/secrets/mySecret' \
--request PATCH \
--header 'Content-Type: application/json' \
--header 'x-api-key: <twoj-sekret-tutaj>' \
--data '{
"secret": "2Fczw/PL7woOzHnGHQ65sT0MbzJjEOlfibyKxy374CqzFyEb2QTS8grtNBgG/0sfIvSHEo9JWN+pUr0NTPs0V6lj",
"key_id": "1200590785272263122"
}'

Jeśli musisz usunąć sekret, żądanie usunięcia wygląda tak:


curl --location 'https://apis.roblox.com/cloud/v2/universes/6930499524/secrets/mySecret' \
--request DELETE \
--header 'Content-Type: application/json' \
--header 'x-api-key: <twoj-sekret-tutaj>'
©2026 Roblox Corporation. Nazwa Roblox, logo Roblox oraz hasło „Powering Imagination” należą do naszych zarejestrowanych i niezarejestrowanych znaków towarowych na terenie Stanów Zjednoczonych oraz w innych krajach.