---
title: "Uwierzytelnianie i klucze API"
description: "Twórz klucze API Requiply, nadawaj im nazwy i je unieważniaj, wybieraj między kluczem publicznym dla sklepów w przeglądarce a kluczem tajnym dla serwerów i poznaj limit żądań."
canonical_url: "https://requiply.com/docs/pl/developers/authentication-and-api-keys"
---
# Uwierzytelnianie i klucze API

> Twórz klucze API Requiply, nadawaj im nazwy i je unieważniaj, wybieraj między kluczem publicznym dla sklepów w przeglądarce a kluczem tajnym dla serwerów i poznaj limit żądań.

Każde żądanie do publicznego API, z SDK lub przez REST, zawiera klucz API jako token typu bearer:

```http
Authorization: Bearer <api-key>
```

## Tworzenie klucza

Kluczami API zarządza się w **Ustawienia → Organizacja → Klucze API** ([app.requiply.com/settings/org/api-keys](https://app.requiply.com/settings/org/api-keys)). Tę stronę widzą tylko członkowie zespołu z rolą **Administrator**.

1. Kliknij **Utwórz klucz**.
2. W polu **Nazwa** wpisz, gdzie klucz jest używany, na przykład *Strona w Lovable* albo *Synchronizacja z księgowością*.
3. Wybierz **Typ**: **Publiczny** lub **Tajny**.
4. Kliknij **Utwórz klucz**, a potem skopiuj klucz z okna **Zapisz teraz ten klucz**.

<warning>

Pełny klucz jest pokazywany tylko raz. Jeśli go zgubisz, utwórz nowy klucz i unieważnij stary.

</warning>

Tabela pokazuje każdy klucz z nazwą, typem, zamaskowaną wartością w kolumnie **Klucz** (prefiks i ostatnie cztery znaki, co wystarcza, by odróżnić klucze), datą utworzenia i datą w kolumnie **Ostatnie użycie**. Ołówek zmienia nazwę klucza. Ikona zakazu go unieważnia: unieważniony klucz przestaje działać natychmiast i nie można go przywrócić. Włącz **Pokaż unieważnione**, aby zobaczyć unieważnione klucze.

## Wybór typu klucza

<table>
<thead>
  <tr>
    <th>
      
    </th>
    
    <th>
      Klucz publiczny (<code>
        rq_pk_…
      </code>
      
      )
    </th>
    
    <th>
      Klucz tajny (<code>
        rq_sk_…
      </code>
      
      )
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Gdzie go używać
      </strong>
    </td>
    
    <td>
      Kod przeglądarki, strona internetowa, aplikacja mobilna
    </td>
    
    <td>
      Tylko kod na serwerze i zmienne środowiskowe
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Dane organizacji, katalog, usługi
      </strong>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Tak
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Dostępność i wyceny
      </strong>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Tak
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Rezerwacje
      </strong>
    </td>
    
    <td>
      Tylko zapytania o rezerwację (<code>
        asRequest: true
      </code>
      
      )
    </td>
    
    <td>
      Tworzenie, lista, odczyt, dodawanie notatek
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Towary na sprzedaż
      </strong>
    </td>
    
    <td>
      Przeglądanie i dodawanie do zapytania o rezerwację, gdy organizacja <a href="https://requiply.com/docs/pl/developers/typescript-sdk/sales#z-kluczem-publicznym">
        sprzedaje klientom
      </a>
    </td>
    
    <td>
      Wszystko z <a href="https://requiply.com/docs/pl/developers/typescript-sdk/sales">
        Sprzedaży
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Klienci, raporty, stan sprzętu, podsumowanie organizacji
      </strong>
    </td>
    
    <td>
      Nie
    </td>
    
    <td>
      Tak
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Pozycje z podnajmu od dostawców
      </strong>
    </td>
    
    <td>
      Nigdy
    </td>
    
    <td>
      Gdy podnajem jest włączony
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Korekty kosztu rezerwacji, rezerwacje poza godzinami pracy
      </strong>
    </td>
    
    <td>
      Nie
    </td>
    
    <td>
      Tak
    </td>
  </tr>
</tbody>
</table>

Pełna lista według punktów końcowych znajduje się w [dokumentacji REST API](https://requiply.com/docs/pl/developers/api-reference#punkty-ko%C5%84cowe).

### Klucze publiczne

Klucz publiczny widzi każdy, kto otworzy kod źródłowy Twojej strony, a API przyjmuje go z dowolnego źródła. Bezpieczny jest dzięki swojemu zakresowi: odczytuje katalog, wycenia i wysyła zapytania o rezerwację, które pracownicy zatwierdzają w aplikacji. Nigdy nie widzi danych klientów ani raportów, nigdy sam nie blokuje sprzętu i nie może kupić towarów ponad stan magazynowy. Jeśli klucz zostanie nadużyty, unieważnij go i utwórz nowy.

```ts
const requiply = new RequiplyClient({ apiKey: 'rq_pk_live_...' });
```

### Klucze tajne

Klucz tajny działa w imieniu całej organizacji, a nie członka zespołu. Trzymaj go w kodzie po stronie serwera i w zmiennych środowiskowych:

```bash
REQUIPLY_SECRET_KEY=rq_sk_live_...
```

```ts
const requiply = new RequiplyClient({
  apiKey: process.env.REQUIPLY_SECRET_KEY!,
});
```

<caution>

Nigdy nie zapisuj prawdziwych kluczy API w repozytorium Git, nie wklejaj kluczy tajnych do kodu przeglądarki i nie udostępniaj ich przez publiczne zmienne środowiskowe, takie jak `NEXT_PUBLIC_…` lub `NUXT_PUBLIC_…`.

</caution>

SDK odrzuca klucz `rq_sk_` w przeglądarce. Ma obejście `dangerouslyAllowSecretKeyInBrowser` dla narzędzi lokalnych, którego integracje produkcyjne nigdy nie powinny ustawiać.

## Limity żądań

Każdy klucz może wykonać 100 żądań na minutę. Kolejne żądania dostają `429` z nagłówkiem `Retry-After` w sekundach, który SDK udostępnia jako `RequiplyError.retryAfter`. Przeglądarki nie mogą odczytać tego nagłówka między różnymi źródłami, więc sklep internetowy powinien odczekać kilka sekund przed ponowną próbą. Zobacz [Obsługa błędów](https://requiply.com/docs/pl/developers/typescript-sdk/error-handling#limity-%C5%BC%C4%85da%C5%84).

## Żądania między źródłami

Publiczne API odpowiada na żądania z dowolnego źródła, więc nie trzeba rejestrować żadnej domeny. Przeglądarki mogą wysyłać nagłówki `Authorization`, `Accept` i `Content-Type`. Żądanie z innego źródła z innym niestandardowym nagłówkiem jest blokowane, zanim dotrze do Requiply.

## Brak trybu testowego

Każdy klucz działa na prawdziwych danych. W interaktywnej dokumentacji i wersjach demonstracyjnych używaj klucza publicznego z organizacji demonstracyjnej, a wszystko, co tworzy rezerwacje lub sprzedaż, kieruj do organizacji, której rekordy możesz usunąć.

## Agenci AI i MCP

Ten sam klucz tajny otwiera też [serwer MCP](https://requiply.com/docs/pl/ai/mcp) Requiply dla agenta, którego budujesz samodzielnie. Wysyłaj go jako token typu bearer na adres `https://api.requiply.com/api/mcp`. Agent dostaje narzędzia dla całej organizacji, na które pozwala klucz tajny, a zapis nadal przechodzi przez etap „najpierw podgląd, potem potwierdzenie” opisany na tamtej stronie. Asystenci tacy jak Claude i ChatGPT łączą się zamiast tego przez OAuth i nie potrzebują klucza. Klucze publiczne nie otwierają serwera MCP.


## Sitemap

See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.