# Klucze API

Source: https://docs.askaniela.com/pl/user/manual/api-keys/

**Do czego służy:** klucze API pozwalają Twoim narzędziom wywoływać AskAniela. Klucze należą do projektu. Pełny
opis: [Klucze API w przewodniku](https://docs.askaniela.com/pl/user/api-keys.md); pierwsze wywołanie: [Szybki start API](https://docs.askaniela.com/pl/user/api-quickstart.md).

![Strona projektu, zakładka Klucze API: lista kluczy z zakresami, wygaśnięciem i akcjami oraz formularz nowego klucza](https://docs.askaniela.com/assets/manual/api-keys.png)

## Krok po kroku

1. Otwórz projekt (**Projekty** w panelu bocznym) i zakładkę **Klucze API**.
2. Wpisz nazwę (np. `crawler-prod`), wybierz termin wygaśnięcia i opcjonalnie dozwolone adresy IP.
3. Kliknij **Nowy klucz**. Pełny klucz widać **tylko raz** - kliknij **Kopiuj**, zachowaj go w bezpiecznym
   miejscu, potem **Gotowe**.
4. Używaj go w nagłówku `Authorization: Bearer gsj_...`.

Lista pokazuje nazwę, początek klucza, zakresy, limit, wygaśnięcie i ostatnie użycie. **Rotuj** tworzy nowy klucz,
a stary działa jeszcze przez okres przejściowy; **Unieważnij** wyłącza klucz od razu.

## Typowe pytania

**Zgubiłem klucz.** Przechowujemy tylko jego odcisk. Zrób rotację albo utwórz nowy klucz.

**Czy API ma osobny budżet?** Nie. Wywołania API korzystają z tego samego salda co aplikacja.

**Kto może tworzyć klucze?** Osoby z prawem zapisu w projekcie; unieważnianie wymaga roli owner albo admin.