rozsireni o keywords a uprava swaggeru

app/main.py

@@ -122,16 +122,21 @@ Plné CRUD nad kampaněmi, sestavami a inzeráty. Tělo je **pole struktur** pod
 [dokumentace Skliku](https://api.sklik.cz/drak/campaigns.create.html); dávka je
 all-or-nothing.
 
+Entita = `campaigns`, `groups`, `ads` nebo `keywords`.
+
 | Operace | Endpoint |
 | --- | --- |
-| Založení | `POST /sklik/{campaigns\\|groups\\|ads}` |
-| Úprava | `PUT /sklik/{campaigns\\|groups\\|ads}` (povinné `id`) |
-| Smazání | `DELETE /sklik/{campaigns\\|groups\\|ads}?ids=1,2` |
-| Obnovení | `POST /sklik/{campaigns\\|groups\\|ads}/restore?ids=1,2` |
+| Založení | `POST /sklik/{entita}` |
+| Úprava | `PUT /sklik/{entita}` (povinné `id`) |
+| Smazání | `DELETE /sklik/{entita}?ids=1,2` |
+| Obnovení | `POST /sklik/{entita}/restore?ids=1,2` |
 
-- **Vše se zakládá pauznuté.** Sklik má výchozí `status: active`, takže
-  neuvedený stav by znamenal živou kampaň – proxy proto při zakládání vždy
-  vynutí `status: "suspend"` a jinou hodnotu ignoruje.
+- **Kampaně, sestavy a inzeráty se zakládají pauznuté.** Sklik má výchozí
+  `status: active`, takže neuvedený stav by znamenal živou kampaň – proxy proto
+  při zakládání vynutí `status: "suspend"` a jinou hodnotu ignoruje.
+- **Klíčová slova jsou výjimka** a pauznutá se nezakládají. Samo o sobě nic
+  neutratí (utrácení hlídá kampaň/sestava/inzerát nad ním) a pauznuté klíčové
+  slovo by způsobilo, že po ručním spuštění kampaně se nic nestane.
 - **`PUT` status nevynucuje** – tím se kampaň pozastavuje (`suspend`) i
   spouští (`active`). Pokud má aktivace zůstat výhradně ruční, nastavte
   `SKLIK_BLOCK_ACTIVATION=true`; pak je `active` odmítnuto s 403.