Referenční příručka pro vývojáře

Průvodce integrací

Přečtěte si referenci API v prostém Markdownu →

Přihlaste se pomocí Google nebo ověřovacího kódu e-mailem a poté otevřete Dashboard → API klíč. Zkopírujte klíč, když se zobrazí: v naší databázi je uložen pouze jeho hash SHA-256. Stávající uživatelé mohou propojit starší klíč pomocí jeho soukromého tokenu pro správu.

Serverová kontrola

POST /api/v1/check
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "text": "Can you quote this project?",
  "email": "[email protected]"
}

Odpovědi zahrnují verdict (allow, block, review), score, reason, engine (jev nebo rules), model (verze poskytovatele u výsledků AI), execution_time_ms a quota_remaining. Skóre z pravidel jsou heuristické odhady. Spolehlivost je přítomna pouze u Jev. Sledování berte jako nejisté, nikoli jako automatické blokování.

Stavové kódy: 400 (neplatný vstup), 401 (chybějící klíč), 403 (neplatný klíč), 429 (kvóta vyčerpána), 503 (služba nedostupná). Maximální velikost zprávy: 10 000 znaků. Volitelné business_context (až 1 000 znaků) popisuje požadované poptávky; neuvádějte tajemství. Selhání poskytovatele se vrací k místním heuristickým pravidlům.

Protokoly detekce a zprávy o provedení

Dashboard → Detection logs zobrazuje vaše ověřené kontroly za posledních 7 dní. Vyberte Uncertain — review ve filtru verdiktů a prohlédněte si nejisté výsledky. Jde o záznam kontrol a nahlášených akcí, nikoli o schránku nebo frontu pro uchovávání či obnovu zpráv. Volitelné site (URL s HTTP/HTTPS; uchovává se pouze její název hostitele) a form_id (až 80 písmen, číslic, podtržítek, dvojteček nebo pomlček) identifikují vaši integraci. Text zprávy je ve výchozím nastavení vypnutý a lze jej povolit ve vašem účtu. Veřejné ukázkové kontroly jsou vyloučeny.

Úspěšné protokolování přidává check_id a report_token k odpovědi kontroly; logging_status je uloženo nebo nedostupné. Selhání protokolování nemění klasifikaci. Uchovávejte token zprávy na svém serveru. Po uplatnění svého rozhodnutí odešlete POST na /api/v1/report se stejným API klíčem:

{
  "check_id": "CHECK_UUID",
  "report_token": "TOKEN_FROM_CHECK",
  "action": "allowed",
  "reason": "verdict"
}

Povolené hodnoty akcí: allowed, blocked, nebo error_allowed. Nejnovější plugin pro WordPress hlásí svou akci automaticky. Pouze sledovat hlásí povoleno s důvodem observe. Chybějící nebo neúspěšné hlášení se zobrazí jako Nehlášeno; povolená akce nepotvrzuje doručení e-mailu.

U vlastní API integrace je pozorování politikou ve vašem vlastním serverovém kódu: zavolejte koncový bod kontroly, zaznamenejte verdikt, pokračujte ve svém běžném toku odesílání a nahlaste akci, kterou jste použili. API kontroly automaticky nepovoluje ani nezakazuje blokování ve vašem formuláři. Pozorování stále zpracovává obsah zprávy a spotřebovává kvótu detekce.

Volitelný pomocník prohlížeče

<form data-formshield> ... </form>
<script src="https://jevshield.com/shield.js" data-key="YOUR_API_KEY"></script>

Pomocník kontroluje pouze výslovně označené formuláře, odesílá pole zprávy, e-mailu a jména a povolí odeslání po selhání sítě nebo 6sekundovém vypršení. Je obejitelný a vystavuje klíč API návštěvníkům. Pro vynucení a zachování soukromí klíče používejte serverové kontroly. Před jeho povolením otestujte pluginy AJAX formulářů.

Směrování leadů

Otevřete Dashboard → Routing a popište své podnikání a volitelně uložte webhook nebo rezervační URL. Kontext účtu se použije, když požadavek neposkytuje vlastní business_context. Výsledky s vysokým záměrem mohou odeslat údaje o dotazu a kontaktu na váš nakonfigurovaný webhook; použijte cíl, který ovládáte, a zahrňte toto zpracování do svého oznámení o ochraně soukromí.

Nakonfigurovaná adresa URL pro rezervaci se vrací jako meeting_url u výsledků s vysokým záměrem. Vaše integrace rozhoduje, zda ji zobrazit, nebo následovat. WordPress plugin a vlastní integrace se mohou chovat odlišně; ověřte kompletní tok návštěvníka. Test webhooku používá syntetický dotaz a potvrzuje cílovou HTTP odpověď, nikoli následné doručení.

Otevřít nastavení směrování →

WordPress

Stáhněte si nejnovější ZIP plugin JevShield, nainstalujte jej do WordPress, poté otevřete Nastavení → JevShield AI a zadejte svůj API klíč a úplný koncový bod HTTPS /api/v1/check. V části Režim ochrany vyberte Pouze sledovat pro klasifikaci a protokolování bez blokování tímto pluginem. Nové instalace začínají v režimu Pouze sledovat; stávající nakonfigurované instalace si zachovávají blokování, dokud režim nezměníte. Sledování využívá kvótu a přenáší pole odeslání ke zpracování, proto jej popište ve svém oznámení o ochraně soukromí. Před přepnutím na Blokovat spam s vysokou spolehlivostí zkontrolujte skutečné doručení svého formuláře.

JevShield je také uveden v Adresář pluginů WordPress.org. Vydání v adresáři mohou dorazit později než ZIP zde; pokud Režim ochrany chybí, aktualizujte pomocí nejnovějšího ZIP. Samostatný starší plugin FormShield si zachovává stávající nastavení a cestu aktualizace. Jeho nastavení obchodního kontextu a přepsání přesného e-mailu nebyla do pluginu JevShield přidána. API stále přijímá business_context pro vlastní integrace.