# Uwierzytelnianie

> Jak uwierzytelniać żądania do API artykułów i skąd wziąć token workspace.

API artykułów pozwala generować szkice artykułów i streszczenia publikacji naukowych z poziomu kodu, a potem sprawdzać ich status.

Bazowy adres: `https://api.prosecaptain.com/api/generate`

## Token

Każde żądanie wymaga tokenu workspace w parametrze `token`:

```text
POST https://api.prosecaptain.com/api/generate/draft?token=TWOJ_TOKEN
```

Token znajdziesz w aplikacji: **Profil** → zakładka **Bezpieczeństwo** → karta **Dane bezpieczeństwa** (przycisk **Pokaż**). To ten sam token co w kodzie widżetu.

Traktuj token jak hasło: używaj go tylko po stronie serwera, nie w kodzie przeglądarki.

## Limity

- Wszystkie endpointy: 100 żądań na 15 minut z jednego adresu IP.
- Generowanie AI (szkic, streszczenia): 10 żądań na minutę.
- Maksymalny rozmiar żądania: 10 MB.
- Długie operacje mogą trwać do 3 minut. Ustaw limit czasu klienta na co najmniej 180 sekund.

## Wspólne pola

| Pole | Domyślnie | Opis |
|---|---|---|
| `keywords` | — | Frazy kluczowe: tablica albo tekst rozdzielony przecinkami. |
| `toneOfVoice` | `professional` | Styl pisania, np. `professional`, `casual`, `formal`. |
| `complexity` | `moderate` | Trudność tekstu: `simple`, `moderate`, `complex` albo liczba (indeks mglistości). |
| `language` | `english` | `polish`/`pl`, `english`/`en`, `german`/`de`, `french`/`fr`. |
| `contentType` | `blogpost` | Rodzaj treści. |