WordPress 사이트 키

Last updated 2026년 9월 29일 Markdown으로 보기 에이전트 설정

WordPress용 AstroWay 플러그인은 등록 없이 키를 직접 받습니다: 웹사이트는 REST 라우트에서 증거를 보여주고, 우리는 이를 확인한 후 해당 웹사이트에 연결된 키를 발급합니다.

어떻게 확인이 진행되는가

플러그인은 proof_id(UUID v4)와 proof(base64url로 인코딩된 32바이트, 43자)를 생성하고 10분간 보관합니다.
웹사이트는 Content-Type: application/json와 본문 {"proof":"<proof>"}로 GET <home_url>/wp-json/astroway/v1/verify?nonce=<proof_id>를 전송합니다.
플러그인은 POST /v1/site-keys를 전송합니다:

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

site_url은 정확히 home_url()이며, ?와 #를 포함하지 않습니다. 간단한 영구 링크의 경우 ?rest_route=/astroway/v1/verify로 verify_url을 전달하세요: 이는 동일한 웹사이트에서만 해당 라우트로 허용됩니다.

키가 제공하는 기능

웹사이트 서버용: 브라우저 요청(Origin 헤더 포함)은 403을 받으며, 각 호출은 X-AstroWay-Site-URL에 웹사이트를 지정해야 합니다. 바인딩은 이 헤더에 유지되므로 키는 비밀로 보관하고, 유출 시 새로 발급받으세요: 이전 키는 폐기됩니다;
무료 읽기 세트, 사이트당 시간당 300 호출, 크레딧 없음; 날짜가 포함된 점성술은 오늘 날짜 근처에서만 허용됩니다;
설치당 하나의 키(호스트 및 홈 경로), 호스트당 최대 5개 설치로 공유 시간 제한이 적용됩니다.

오류: 400 INVALID_SITE_URL, 422 SITE_VERIFICATION_FAILED와 details.reason, 429 SITE_KEY_RATE_LIMIT와 retry_after.

계정 연결

웹사이트 소유자가 자신의 플랜으로 작업하려면, 플러그인은 한 번의 클릭으로 웹사이트를 계정 키로 전환합니다.

플러그인은 관리자 브라우저에서 https://api.astroway.info/dashboard/connect?site=<home_url>&return=<admin_url>&state=<16-128 문자>&source=wp_plugin를 엽니다. return은 site와 동일한 호스트에 있어야 하며, https여야 합니다.
관리자는 로그인하거나 등록하고 웹사이트 키를 선택하거나 새로 생성합니다. 다른 도메인에 이미 연결된 키는 별도 확인 후만 이전됩니다.
브라우저는 동일한 state로 code를 포함하여 return으로 돌아옵니다. 취소 시 error=access_denied가 반환됩니다.
웹사이트 서버는 X-Api-Key에 자신의 사이트 키를 전송하여 코드를 교환합니다:

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

응답: { "key": "aw_live_…", "plan": "free", "domain": "example.com", "account": "j***@example.com" }. 코드는 5분간 유효합니다. 동일한 사이트 키로 10분 내 동일한 코드를 다시 교환하면 동일한 응답이 반환됩니다. 사이트 키는 교환 후 24시간 후에 만료됩니다.

오류: 400 INVALID_CODE, 410 CODE_EXPIRED, 403 SITE_MISMATCH.