使用 Google 或邮箱验证码登录，然后打开控制台 → API 密钥。密钥显示后请立即复制：我们的数据库只保存其 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 结果包含置信度。请将 review 视为不确定结果，而非自动拦截。
状态码： 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 插件会自动上报实际动作。仅观察模式上报 allowed，原因值为 observe。未上报或上报失败会显示“未上报”；allowed 动作不能证明邮件已送达。
对于自定义 API 集成，观察是你在服务端代码中实现的策略：调用检测接口、记录判定、继续正常提交流程，并上报实际执行的动作。检测 API 不会自动打开或关闭表单拦截。观察仍会处理消息内容并消耗检测额度。
可选浏览器辅助脚本
<form data-formshield> ... </form> <script src="https://jevshield.com/shield.js" data-key="YOUR_API_KEY"></script>
辅助脚本仅检查明确标记的表单，发送消息、邮箱和姓名字段，并在网络失败或等待 6 秒超时后允许提交。它可以被绕过，且会将 API 密钥暴露给访客。请使用服务端检查执行拦截并保护密钥。启用前请测试 AJAX 表单插件。
线索分流
打开控制台 → 路由，描述你的业务，并可选择保存 webhook 或预约 URL。当请求未提供自己的 business_context 时，将使用账户中保存的业务背景。高意向结果可将咨询内容和联系信息发送到你配置的 webhook；请使用你可控制的接收地址，并在隐私声明中说明这项处理。
高意向结果会通过 meeting_url 返回已配置的预约地址。是否展示或跳转，由你的集成决定。WordPress 插件与自定义集成的行为可能不同，请验证完整访客流程。Webhook 测试发送模拟咨询，只确认目标地址的 HTTP 响应，不代表下游实际投递成功。
打开路由设置 →WordPress
下载最新版 JevShield 插件 ZIP，在 WordPress 中安装，然后打开“设置 → JevShield AI”，输入 API 密钥和完整的 HTTPS /api/v1/check 地址。在“防护模式”中选择“仅观察”，插件会分类并记录，但不会拦截。新安装默认使用仅观察模式；已配置的安装会继续拦截，直到你更改模式。观察也会消耗额度，并传输提交字段进行处理，请在隐私声明中说明。切换到“拦截高置信度垃圾消息”之前，先检查表单的实际投递情况。
JevShield 也已上架 WordPress.org 插件目录。目录中的版本可能晚于这里的 ZIP 包；如果看不到“防护模式”，请使用最新 ZIP 更新。独立的旧版 FormShield 插件保留原有设置和更新方式，其业务背景与指定邮箱放行设置尚未加入 JevShield 插件。自定义集成仍可通过 API 传入 business_context。