Przejdź do treści

Klucze API

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; pierwsze wywołanie: Szybki start API.

Strona projektu, zakładka Klucze API: lista kluczy z zakresami, wygaśnięciem i akcjami oraz formularz nowego klucza

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.