WordPress için Site Anahtarı

WordPress için AstroWay eklentisi, kayıt olmadan kendisi anahtar alır: site, REST yolunda kanıt gösterir, biz bunu kontrol eder ve bu siteye bağlı bir anahtar verir.

Doğrulama nasıl yapılır

1. Eklenti, proof_id (UUID v4) ve proof (32 rastgele bayt base64url, 43 karakter) oluşturur ve bunları 10 dakika tutar.
2. Site, Content-Type: application/json ile GET <home_url>/wp-json/astroway/v1/verify?nonce=<proof_id> gönderir ve gövde olarak {"proof":"<proof>"} içerir.
3. Eklenti, POST /v1/site-keys gönderir:

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

site_url tam olarak home_url(), ? ve # olmadır. Basit kalıcı bağlantılar için ?rest_route=/astroway/v1/verify ile verify_url gönderin: bu yalnızca aynı sitede ve bu rota olarak kabul edilir.

Anahtar ne sağlar

• sunucu için: tarayıcıdan gelen istek (Origin başlığı ile) 403 alır, her çağrı X-AstroWay-Site-URL içinde siteyi belirtmelidir. Bağlantı bu başlıkta tutulur, bu yüzden anahtarı gizli olarak saklayın, eğer sızarsa yeni alın: önceki iptal edilecektir;
• ücretsiz okumalar seti, site başına saatte 300 çağrı, kredisiz; tarihli burçlar yalnızca bugüne yakın tarihlerde kabul edilir;
• kurulum başına bir anahtar (host ve ana yol), host başına 5 kurulum, ortak saat ile.

Hatalar: 400 INVALID_SITE_URL, 422 SITE_VERIFICATION_FAILED ile details.reason, 429 SITE_KEY_RATE_LIMIT ile retry_after.

Hesap Bağlantısı

Site sahibi kendi planında çalışmak istediğinde, eklenti siteyi tek tıkla hesap anahtarına taşır.

1. Eklenti, yönetici tarayıcısında https://api.astroway.info/dashboard/connect?site=<home_url>&return=<admin_url>&state=<16-128 karakter>&source=wp_plugin açar. return, site ile aynı hostta ve https üzerinde olmalıdır.
2. Yönetici giriş yapar veya kaydolur ve site için anahtar seçer veya yeni oluşturur. Başka bir domaine bağlı olan anahtar, ayrı onaydan sonra taşınır.
3. Tarayıcı, code ve aynı state ile return adresine geri döner. İptal error=access_denied döner.
4. Site sunucusu, kodu X-Api-Key içinde site anahtarını göndererek değiştirir:

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

Yanıt: { "key": "aw_live_…", "plan": "free", "domain": "example.com", "account": "j***@example.com" }. Kod 5 dakika yaşar. 10 dakika içinde aynı kodun aynı site anahtarıyla tekrar değiştirilmesi aynı yanıtı döner. Site anahtarı, değiştirmeden 24 saat sonra geçersiz olur.

Hatalar: 400 INVALID_CODE, 410 CODE_EXPIRED, 403 SITE_MISMATCH.