Uwierzytelnianie

Utwórz klucz

Otwórz zakładkę Settings, a potem API keys. Nadaj kluczowi nazwę, która mówi, gdzie będzie używany, i go utwórz.

Klucz jest pokazywany tylko raz. Skopiuj go od razu i zachowaj w bezpiecznym miejscu, na przykład w zmiennych środowiskowych swojego serwera. Setherion przechowuje tylko jego odcisk, więc nikt nie może ci go pokazać ponownie, nawet my. Jeśli go zgubisz, unieważnij go i utwórz nowy.

Klucz zaczyna się od sth_, po którym następuje 43 losowych liter, cyfr, - i _, razem 47 znaków. Nazwa może mieć do 60 znaków, a dłuższa zostaje obcięta.

Wysyłaj go z każdym żądaniem

Umieść klucz w nagłówku Authorization:

curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"

const res = await fetch('https://www.setherion.com/api/v1/projects', {
  headers: { Authorization: `Bearer ${process.env.SETHERION_API_KEY}` },
})
const data = await res.json()

Odczytywany jest tylko schemat Bearer. Żądanie bez prawidłowego klucza dostaje 401:

{
  "ok": false,
  "error": "A valid API key is required. Make one on your Setherion account page and send it as \"Authorization: Bearer sth_...\"."
}

Brakujący nagłówek, klucz z literówką, klucz, który nie istnieje, i klucz, który został unieważniony, dostają tę samą odpowiedź, więc nigdy nie dowiesz się, który z tych przypadków zaszedł.

Co może zrobić klucz

Klucz działa jako ty. Może robić to, co ty możesz robić w Setherion:

• zobaczyć aplikacje w twoim panelu, własne i te udostępnione tobie;
• przeczytać przewodnik po sklepach z aplikacjami i odpowiedzi o prywatności każdej aplikacji, którą możesz otworzyć;
• zmieniać aplikacje, które możesz edytować, wydając kredyty tak samo jak edycja w edytorze;
• publikować aplikacje, które możesz edytować, i pisać ich stronę sklepową.

Resztę rozstrzyga twoja rola w każdej aplikacji. Wywołanie, które odczytuje, wymaga roli viewer lub wyższej, a wywołanie, które zmienia aplikację albo wydaje kredyty, wymaga roli editor lub wyższej. W części Wprowadzenie zobaczysz, które wywołanie wymaga której roli.

Klucz nie może zmieniać twojego konta, planu ani płatności i nie może tworzyć ani unieważniać kluczy: jest to możliwe tylko wtedy, gdy logujesz się do Setherion samodzielnie, więc jeden wyciekły klucz nigdy nie wyda kolejnych.

Unieważnij klucz

W sekcji API keys kliknij Revoke obok klucza. Przestaje on działać natychmiast. Unieważnione klucze zostają na liście, żeby było widać, kiedy ostatnio były używane.

Możesz mieć naraz do 10 aktywnych kluczy. Prośba o 11. klucz zostaje odrzucona z komunikatem You have 10 active keys. Revoke one you no longer use to make another. Lista pokazuje, kiedy każdy klucz był ostatnio używany, a ta informacja odświeża się najwyżej raz na minutę.

Logowanie bez klucza

Asystenci AI łączą się przez stronę logowania i przycisk Allow zamiast klucza. Zobacz MCP: podłącz asystenta AI.

Tokeny, które daje takie logowanie, działają tylko na adresie asystenta (/api/mcp). Punkty końcowe w tej dokumentacji przyjmują wyłącznie klucz API.