# Klíč webu pro WordPress

Plugin AstroWay pro WordPress získává klíč sám, bez registrace: web ukazuje důkaz na svém REST‑trasu, my jej ověříme a vydáme klíč připojený k tomuto webu.

## Jak probíhá ověření

1. Plugin generuje `proof_id` (UUID v4) a `proof` (32 náhodných bajtů v base64url, 43 znaků) a drží je 10 minut.
2. Web vrací `GET <home_url>/wp-json/astroway/v1/verify?nonce=<proof_id>` s `Content-Type: application/json` a tělem `{"proof":"<proof>"}`.
3. Plugin odesílá `POST /v1/site-keys`:

```json
{ "site_url": "https://example.com", "proof_id": "3f1c2a9e-8b7d-4c1e-9f3a-2b6d5e4c1a07", "proof": "<43 символи>" }
```

`site_url` je přesně `home_url()`, bez `?` a `#`. Pro jednoduché trvalé odkazy pošlete `verify_url` s `?rest_route=/astroway/v1/verify`: je akceptován jen na stejném webu a jen jako tato cesta.

## Co klíč poskytuje

- pro server webu: požadavek z prohlížeče (s hlavičkou `Origin`) získá 403, a každý volání musí uvádět web v `X-AstroWay-Site-URL`. Vazba je udržována na této hlavičce, takže klíč uchovávej jako tajemství, a pokud unikne, získej nový: předchozí bude odvolán;
- sada bezplatných čtení, 300 volání za hodinu na web, bez kreditů; horoskopy s datem jsou přijímány jen kolem dnešního data;
- jeden klíč na instalaci (host a domovská cesta), až 5 instalací na host se společnou hodinou.

Chyby: `400 INVALID_SITE_URL`, `422 SITE_VERIFICATION_FAILED` s `details.reason`, `429 SITE_KEY_RATE_LIMIT` s `retry_after`.