Démarrage rapide

<script src="https://api.antisy.com/v1/i/l.js"
        data-site="VOTRE_CLE_DE_SITE" defer></script>

<form method="post" action="/contact">
  <input name="name" autocomplete="name">
  <input name="email" type="email" autocomplete="email">
  <textarea name="message"></textarea>
  <button>Envoyer</button>
</form>

#!/bin/sh
# ANTISY_SECRET : votre secret de vérification, dans l'environnement, jamais en dur.
# ANTISY_TOKEN  : le champ antisy-token reçu avec le formulaire.
# Sortie 0 : accepté. Sortie 2 : refusé, ou envoi non vérifié.
LC_ALL=C

# 1. Un jeton présent doit avoir la forme d'un jeton : 1 à 2048 caractères ASCII imprimables.
#    Sinon on n'appelle pas Antisy et on ne laisse pas passer.
if [ -n "$ANTISY_TOKEN" ]; then
  case "$ANTISY_TOKEN" in
    *[!\ -~]*) echo "Jeton mal formé, envoi non vérifié" >&2; exit 2 ;;
  esac
  if [ "$(( $(printf '%s' "$ANTISY_TOKEN" | wc -c) ))" -gt 2048 ]; then
    echo "Jeton trop long, envoi non vérifié" >&2; exit 2
  fi
fi

# 2. L'appel. Le secret passe par l'entrée standard : il n'apparaît pas dans la liste des processus.
body=$(printf 'secret=%s' "$ANTISY_SECRET" | curl -sS --max-time 3 -w '\n%{http_code}' \
  https://api.antisy.com/v1/siteverify \
  -d @- \
  --data-urlencode response="$ANTISY_TOKEN")
curl_status=$?
http_code=$(printf '%s' "$body" | tail -n1)

# 3. On laisse passer seulement quand Antisy ne répond pas : panne réseau, délai dépassé, 5xx.
#    Le 429 aussi, par défaut : voir la page sur la vérification avant de garder ce choix.
if [ "$curl_status" -ne 0 ] || [ "$http_code" -ge 500 ] || [ "$http_code" = 429 ]; then
  echo "Antisy ne répond pas (curl $curl_status, HTTP $http_code), envoi laissé passer" >&2
  exit 0
fi
# Tout autre statut d'erreur est un défaut de votre appel : à corriger, et jamais un laissez-passer.
if [ "$http_code" -ge 400 ]; then
  echo "Requête refusée par Antisy (HTTP $http_code), envoi non vérifié" >&2
  exit 2
fi

# 4. Réponse JSON compacte : grep suffit ici, utilisez un vrai lecteur JSON dans votre code.
if printf '%s' "$body" | grep -q '"success":true'; then
  exit 0   # visiteur accepté
else
  exit 2   # deny : refus générique, sans dire pourquoi
fi

// antisy.mjs : Node 22 ou plus, sans dépendance.
// Rend "allow" ou "deny".
// Antisy ne répond pas (réseau, délai, 5xx) : "allow". Tout le reste d'incertain : "deny".

// Le 429 est une décision qui vous appartient. "allow" par défaut, comme pour une panne ;
// pour un formulaire sensible, mettez "deny" (voir la page sur la vérification).
const ON_RATE_LIMIT = "allow";

export async function antisyVerdict(token) {
  // 1. Un jeton présent doit avoir la forme d'un jeton : 1 à 2048 caractères ASCII imprimables.
  //    Sinon, on n'appelle pas Antisy et on ne laisse pas passer.
  //    Un champ vide ou absent (script bloqué) part comme une chaîne vide : Antisy le lit comme un jeton absent.
  if (token && !/^[\x20-\x7e]{1,2048}$/.test(token)) {
    console.warn("Jeton mal formé, envoi non vérifié");
    return "deny";
  }

  let response;
  try {
    response = await fetch("https://api.antisy.com/v1/siteverify", {
      method: "POST",
      // fetch suit les redirections par défaut : une 3xx rejouerait le corps, secret compris, ailleurs.
      // Ici elle est une erreur de votre appel (refusée plus bas).
      redirect: "manual",
      // Un corps URLSearchParams part en application/x-www-form-urlencoded.
      body: new URLSearchParams({
        secret: process.env.ANTISY_SECRET, // votre secret, jamais dans la page
        response: token ?? "",             // le champ antisy-token, tel que reçu
      }),
      signal: AbortSignal.timeout(3000),   // au-delà de 3 s, Antisy ne répond pas
    });
  } catch (error) {
    console.warn("Antisy injoignable, envoi laissé passer :", error.name);
    return "allow";
  }
  if (response.status >= 500) {
    console.warn("Antisy a répondu " + response.status + ", envoi laissé passer");
    return "allow";
  }
  if (response.status === 429) {
    console.warn("Antisy a répondu 429, décision : " + ON_RATE_LIMIT);
    return ON_RATE_LIMIT;
  }
  if (!response.ok) {
    // 400, 401, 413, 415... : le défaut est dans votre appel. À corriger, jamais un laissez-passer.
    console.error("Antisy a refusé la requête (" + response.status + "), envoi non vérifié");
    return "deny";
  }
  const result = await response.json().catch(() => null);
  if (typeof result?.success !== "boolean") {
    console.error("Réponse d'Antisy illisible, envoi non vérifié");
    return "deny";
  }
  // Un secret absent ou refusé n'est pas une erreur HTTP : la réponse est un refus, à 200.
  const codes = result["error-codes"] ?? [];
  if (codes.includes("missing-input-secret") || codes.includes("invalid-input-secret")) {
    console.error("Antisy refuse le secret : " + codes.join(", "));
  }
  // success est la seule acceptation : il vaut true si et seulement si verdict vaut "allow".
  return result.success ? "allow" : "deny";
}

import { antisyVerdict } from "./antisy.mjs";

// Dans le gestionnaire de votre formulaire, après l'analyse du corps :
const verdict = await antisyVerdict(body["antisy-token"]);
if (verdict === "deny") return refuse(); // refus générique, sans dire pourquoi
return accept();