Google 또는 이메일 인증 코드로 로그인한 다음 Dashboard → API key를 여세요. 표시될 때 키를 복사하세요. 데이터베이스에는 SHA-256 해시만 저장됩니다. 기존 사용자는 비공개 관리 토큰을 사용하여 레거시 키를 연결할 수 있습니다.
서버 측 검사
POST /api/v1/check
Content-Type: application/json
x-api-key: YOUR_API_KEY
{
"text": "Can you quote this project?",
"email": "[email protected]"
}응답에는 다음이 포함됩니다 verdict (allow, block, review), score, reason, engine (jev 또는 rules), model (AI 결과에 대한 제공자 버전), execution_time_ms 및 quota_remaining. 규칙의 점수는 휴리스틱 추정치입니다. 신뢰도는 Jev에만 존재합니다. 검토를 불확실한 것으로 취급하고 자동 차단으로 취급하지 마세요.
상태 코드: 400 (잘못된 입력), 401 (키 누락), 403 (잘못된 키), 429 (할당량 소진), 503 (서비스 이용 불가). 최대 메시지 크기: 10,000자. 선택 사항 business_context (최대 1,000자)는 원하는 문의를 설명합니다. 비밀 정보를 포함하지 마세요. 제공자 장애 시 로컬 휴리스틱 규칙으로 대체됩니다.
탐지 로그 및 실행 보고서
대시보드 → 탐지 로그에는 최근 7일간의 인증된 검사가 표시됩니다. 불확실한 결과를 검사하려면 판정 필터에서 불확실 — 검토를 선택하세요. 이는 검사 및 보고된 조치의 기록이며, 메시지를 보관하거나 복원하는 받은 편지함이나 대기열이 아닙니다. 선택적 site(HTTP/HTTPS URL, 호스트 이름만 보관됨)와 form_id(최대 80자의 문자, 숫자, 밑줄, 콜론 또는 하이픈)는 통합을 식별합니다. 메시지 텍스트는 기본적으로 꺼져 있으며 계정에서 활성화할 수 있습니다. 공개 데모 검사는 제외됩니다.
성공적인 로깅 추가 check_id 및 report_token 검사 응답에 포함되며, logging_status는 saved 또는 unavailable입니다. 로깅 실패는 분류를 바꾸지 않습니다. 보고서 토큰은 서버에 보관하세요. 결정을 적용한 후 다음으로 POST하세요 /api/v1/report 동일한 API 키로:
{
"check_id": "CHECK_UUID",
"report_token": "TOKEN_FROM_CHECK",
"action": "allowed",
"reason": "verdict"
}허용된 작업 값: allowed, blocked, 또는 error_allowed. 최신 WordPress 플러그인은 해당 작업을 자동으로 보고합니다. Observe only는 observe 사유와 함께 허용됨으로 보고합니다. 누락되거나 실패한 보고는 Not reported로 표시됩니다. 허용된 작업이 이메일 전달을 확인하지는 않습니다.
사용자 지정 API 통합의 경우, 관찰은 자체 서버 코드의 정책입니다. 검사 엔드포인트를 호출하고, 판정을 기록하고, 정상적인 제출 흐름을 계속하고, 적용한 조치를 보고하세요. 검사 API는 양식에서 차단을 자동으로 활성화하거나 비활성화하지 않습니다. 관찰 모드도 메시지 내용을 처리하고 탐지 할당량을 사용합니다.
선택적 브라우저 도우미
<form data-formshield> ... </form> <script src="https://jevshield.com/shield.js" data-key="YOUR_API_KEY"></script>
도우미는 명시적으로 표시된 양식만 검사하고, 메시지, 이메일 및 이름 필드를 전송하며, 네트워크 실패 또는 6초 시간 초과 후 제출을 허용합니다. 이는 우회 가능하며 방문자에게 API 키를 노출합니다. 강제 적용을 위해 그리고 키를 비공개로 유지하기 위해 서버 측 검사를 사용하세요. 활성화하기 전에 AJAX 양식 플러그인을 테스트하세요.
리드 라우팅
대시보드 → 라우팅을 열어 비즈니스를 설명하고 선택적으로 웹훅 또는 예약 URL을 저장하세요. 계정 컨텍스트는 요청이 자체 business_context를 제공하지 않을 때 사용됩니다. 높은 의도의 결과는 문의 및 연락처 세부 정보를 구성된 웹훅으로 전송할 수 있습니다. 통제하는 대상을 사용하고 이 처리를 개인정보 처리방침에 포함하세요.
구성된 예약 URL은 높은 의도 결과에 대해 meeting_url로 반환됩니다. 표시할지 따라갈지는 통합에서 결정합니다. WordPress 플러그인과 사용자 정의 통합은 동작이 다를 수 있으므로 전체 방문자 흐름을 확인하세요. 웹훅 테스트는 합성 문의를 사용하며 다운스트림 전달이 아닌 대상 HTTP 응답을 확인합니다.
라우팅 설정 열기 →WordPress
최신 JevShield 플러그인 ZIP 다운로드, WordPress에 설치한 다음 Settings → JevShield AI를 열고 API 키와 전체 HTTPS /api/v1/check 엔드포인트를 입력하세요. Protection Mode에서 Observe only를 선택하면 이 플러그인이 차단하지 않고 분류하고 기록합니다. 새 설치에서는 Observe only로 시작합니다. 기존에 구성된 설치에서는 모드를 변경할 때까지 차단이 유지됩니다. 관찰은 할당량을 사용하고 처리를 위해 제출 필드를 전송하므로 개인정보 처리방침에 이를 설명하세요. Block high-confidence spam으로 전환하기 전에 양식의 실제 전달을 확인하세요.
JevShield는 또한 다음에 등록되어 있습니다 WordPress.org 플러그인 디렉터리. 디렉터리 릴리스는 여기의 ZIP보다 늦게 도착할 수 있습니다. Protection Mode가 없으면 최신 ZIP을 사용하여 업데이트하세요. 별도의 레거시 FormShield 플러그인은 기존 설정과 업데이트 경로를 유지합니다. 비즈니스 컨텍스트 및 정확한 이메일 재정의 설정은 JevShield 플러그인에 추가되지 않았습니다. API는 사용자 지정 통합을 위해 여전히 business_context를 허용합니다.