Klíč webu pro WordPress

Plugin AstroWay pro WordPress získá klíč sám, bez registrace: web ukáže důkaz na své REST cestě, my ho ověříme a vydáme klíč, vázaný k tomuto webu.

Jak probíhá ověření

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

{ "site_url": "https://example.com", "proof_id": "3f1c2a9e-8b7d-4c1e-9f3a-2b6d5e4c1a07", "proof": "<43 characters>" }

site_url je přesně home_url(), bez ? a #. Pro jednoduché trvalé odkazy předej verify_url s ?rest_route=/astroway/v1/verify: je přijímán pouze na stejném webu a pouze jako tato cesta.

Co klíč poskytuje

• pro server webu: požadavek z prohlížeče (s hlavičkou Origin) obdrží 403, a každé volání musí uvést web v X-AstroWay-Site-URL. Vazba se drží na této hlavičce, takže klíč uchovávej jako tajemství, a pokud unikl, získej nový: předchozí bude zrušen;
• sada bezplatných čtení, 300 volání za hodinu na web, bez kreditů; horoskopy s datem jsou přijímány pouze v blízkosti dnešního data;
• jeden klíč na instalaci (host a domovská cesta), až 5 instalací na host se sdílenou hodinou.

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

Připojení účtu

Když majitel webu chce pracovat na svém plánu, plugin převede web na klíč účtu jedním kliknutím.

1. Plugin otevře v prohlížeči administrátora https://api.astroway.info/dashboard/connect?site=<home_url>&return=<admin_url>&state=<16-128 znaků>&source=wp_plugin. return musí být na stejném hostu jako site a na https.
2. Administrátor se přihlásí nebo zaregistruje a vybere klíč pro web nebo vytvoří nový. Klíč, již vázaný k jiné doméně, je přenesen pouze po samostatném potvrzení.
3. Prohlížeč se vrátí na return s code a stejným state. Zrušení vrátí error=access_denied.
4. Server webu vymění kód, odesláním svého klíče webu v X-Api-Key:

POST /v1/site-keys/connect/exchange
{ "code": "<43 characters>", "site_url": "https://example.com" }

Odpověď: { "key": "aw_live_…", "plan": "free", "domain": "example.com", "account": "j***@example.com" }. Kód žije 5 minut. Opakovaná výměna stejného kódu stejným klíčem webu během 10 minut vrátí stejnou odpověď. Klíč webu přestane platit 24 hodin po výměně.

Chyby: 400 INVALID_CODE, 410 CODE_EXPIRED, 403 SITE_MISMATCH.