使い方

Pitform はフォームの「送信先」だけを提供します。フォームの見た目はあなたのサイトのままで構いません。

1. 基本の設置

ダッシュボードでフォームを作ると発行されるURLを、action に指定します。name 属性の付いた項目がそのまま届きます。

<form action="https://pitform.app/f/あなたのID" method="POST">
  <input type="text" name="name">
  <input type="email" name="email">
  <textarea name="message"></textarea>
  <button type="submit">送信</button>
</form>

2. スパム対策

次の1行を入れておくと、botの送信を自動で捨てます（送信者側には成功したように見せるので、 bot に対策の存在を悟らせません）。

<!-- 人間には見えない項目。botが埋めると自動で破棄されます -->
<input type="text" name="_gotcha" style="display:none" tabindex="-1" autocomplete="off">

さらに強くしたい場合は、フォーム設定から Cloudflare Turnstile を有効にできます。

3. JavaScript から送る

Accept: application/json を付けるとJSONで応答します。ページ遷移せずに送信したいときに使ってください。

const res = await fetch('https://pitform.app/f/あなたのID', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
  body: JSON.stringify({ name, email, message })
});
const result = await res.json(); // { ok: true, id: "..." }

予約フィールド

名前	意味
`_gotcha`	ハニーポット。値が入っていたら破棄する
`_redirect`	送信後の遷移先（フォーム設定が優先）
`email` / `_replyto`	自動返信の宛先、通知メールの Reply-To

スマホで通知を受け取る

受信箱をスマホのブラウザで開き、「通知をオンにする」を押すだけです。 iPhone / iPad の場合は、Safari の共有ボタンから「ホーム画面に追加」して、追加されたアイコンから開き直してから通知をオンにしてください（iOS の仕様で、ホーム画面に追加した状態でないと通知を受け取れません）。