Lewati ke konten
AstroWay/api v2.248.0 · id
semua sistem normal

Kunci situs untuk WordPress

Plugin AstroWay untuk WordPress mendapatkan kunci sendiri, tanpa registrasi: situs menunjukkan bukti pada rute REST-nya, kami memverifikasinya dan mengeluarkan kunci yang terikat pada situs ini.

  1. Plugin menghasilkan proof_id (UUID v4) dan proof (32 byte acak dalam base64url, 43 karakter) dan menyimpannya selama 10 menit.
  2. Situs mengembalikan GET <home_url>/wp-json/astroway/v1/verify?nonce=<proof_id> dengan Content-Type: application/json dan body {"proof":"<proof>"}.
  3. Plugin mengirimkan POST /v1/site-keys:
{ "site_url": "https://example.com", "proof_id": "3f1c2a9e-8b7d-4c1e-9f3a-2b6d5e4c1a07", "proof": "<43 characters>" }

site_url persis home_url(), tanpa ? dan #. Untuk permalink sederhana, berikan verify_url dengan ?rest_route=/astroway/v1/verify: ini hanya diterima di situs yang sama dan hanya sebagai rute ini.

  • untuk server situs: permintaan dari browser (dengan header Origin) menerima 403, dan setiap panggilan harus menyebutkan situs di X-AstroWay-Site-URL. Pengikatan bergantung pada header ini, jadi simpan kunci sebagai rahasia, dan jika bocor, dapatkan yang baru: yang sebelumnya akan dicabut;
  • satu set bacaan gratis, 300 panggilan per jam per situs, tanpa kredit; horoskop dengan tanggal hanya diterima di sekitar tanggal hari ini;
  • satu kunci per instalasi (host dan jalur beranda), hingga 5 instalasi per host dengan jam bersama.

Kesalahan: 400 INVALID_SITE_URL, 422 SITE_VERIFICATION_FAILED dengan details.reason, 429 SITE_KEY_RATE_LIMIT dengan retry_after.

Ketika pemilik situs ingin bekerja dengan paketnya sendiri, plugin akan mengalihkan situs ke kunci akun dalam satu klik.

  1. Plugin membuka di browser administrator https://api.astroway.info/dashboard/connect?site=<home_url>&return=<admin_url>&state=<16-128 karakter>&source=wp_plugin. return harus berada di host yang sama dengan site, dan menggunakan https.
  2. Administrator masuk atau mendaftar dan memilih kunci untuk situs atau membuat yang baru. Kunci yang sudah terikat ke domain lain hanya dapat dipindahkan setelah konfirmasi terpisah.
  3. Browser kembali ke return dengan code dan state yang sama. Pembatalan mengembalikan error=access_denied.
  4. Server situs menukar kode dengan mengirimkan kunci situsnya di X-Api-Key:
POST /v1/site-keys/connect/exchange
{ "code": "<43 characters>", "site_url": "https://example.com" }

Respons: { "key": "aw_live_…", "plan": "free", "domain": "example.com", "account": "j***@example.com" }. Kode berlaku selama 5 menit. Penukaran ulang kode yang sama dengan kunci situs yang sama dalam 10 menit mengembalikan respons yang sama. Kunci situs berhenti berlaku 24 jam setelah penukaran.

Kesalahan: 400 INVALID_CODE, 410 CODE_EXPIRED, 403 SITE_MISMATCH.

Bermanfaat?
Usulkan perbaikan

Terakhir diperbaharui: