お問い合わせ(デモ)
公開 ID: 4DWQD68vxWaykHJAPUi1m
設定
サイトに組み込むための情報(制作担当者向け)埋め込みコード、確認用のフォーム、API の仕様
埋め込みコード
サイトの HTML に貼ると、このフォームに送信できます。ボット対策の行は消さないでください。 「送信を受け付けるサイト」が空なので、どのサイトからでも送れます。フォームを置くサイトのアドレスを入れてください。
確認用のフォームを開く(同じ項目のフォームを開いて、試しに送れます。送った内容は「お問い合わせ」に届きます)
送信先:
https://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m<form action="https://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m" method="POST" enctype="multipart/form-data">
<div data-ccf="input">
<label>お名前 * <input type="text" name="お名前" required></label>
<label>メールアドレス * <input type="email" name="email" required></label>
<label>ご用件 *
<select name="ご用件" required>
<option value="">選んでください</option>
<option value="お見積もり">お見積もり</option>
<option value="資料請求">資料請求</option>
<option value="その他">その他</option>
</select>
</label>
<label>お問い合わせ内容 * <textarea name="本文" required></textarea></label>
<fieldset>
<legend>チェックボックス *</legend>
<label><input type="checkbox" name="チェックボックス" value="テスト1"> テスト1</label>
<label><input type="checkbox" name="チェックボックス" value="テスト2"> テスト2</label>
<label><input type="checkbox" name="チェックボックス" value="テスト3"> テスト3</label>
<label><input type="checkbox" name="チェックボックス" value="テスト4"> テスト4</label>
<label><input type="checkbox" name="チェックボックス" value="テスト5"> テスト5</label>
<label><input type="checkbox" name="チェックボックス" value="テスト6"> テスト6</label>
</fieldset>
</div>
<!-- 確認画面(「入力内容を確認する」で出る) -->
<div data-ccf="confirm" style="display:none">
<p data-ccf="note" tabindex="-1">以下の内容で送信します。よろしければ「送信する」を押してください。</p>
<dl data-ccf="summary"></dl>
</div>
<!-- ボット対策(消さない)。人には見えない欄と、ページを開いた時刻 -->
<input type="text" name="_hp" tabindex="-1" autocomplete="off" aria-hidden="true" style="position:absolute;left:-9999px">
<input type="hidden" name="_ts">
<script>document.currentScript.previousElementSibling.value = Date.now();</script>
<div class="cf-turnstile" data-sitekey="0x4AAAAAAF5eyEO1FRg1lUrN"></div>
<button type="submit" data-ccf="next">送信</button>
<button type="button" data-ccf="back" style="display:none">修正する</button>
<button type="submit" data-ccf="send" style="display:none">送信する</button>
<script>
(function () {
var E = Element.prototype;
var form = E.closest.call(document.currentScript, "form");
if (!form) return;
var defs = [{"n":"お名前","l":"お名前","t":"text","r":true},{"n":"email","l":"メールアドレス","t":"email","r":true},{"n":"ご用件","l":"ご用件","t":"select","r":true},{"n":"本文","l":"お問い合わせ内容","t":"textarea","r":true},{"n":"チェックボックス","l":"チェックボックス","t":"checkbox","r":true}];
var part = function (k) { return E.querySelector.call(form, "[data-ccf=" + k + "]"); };
var p = { input: part("input"), confirm: part("confirm"), summary: part("summary"), note: part("note"), next: part("next"), back: part("back"), send: part("send") };
for (var k in p) if (!p[k]) return; // 部品が欠けていれば確認なしで送る
var show = function (el, on) { if (on) el.style.removeProperty("display"); else el.style.setProperty("display", "none", "important"); };
var byName = function (n) { return Array.prototype.filter.call(E.querySelectorAll.call(form, "input, select, textarea"), function (el) { return el.name === n; }); };
var mode = function (confirming, scroll) {
E.setAttribute.call(form, "data-ccf-mode", confirming ? "confirm" : "input");
show(p.input, !confirming); show(p.next, !confirming);
show(p.confirm, confirming); show(p.back, confirming); show(p.send, confirming);
if (!scroll) return;
if (E.getBoundingClientRect.call(form).top < 0) E.scrollIntoView.call(form);
// 画面が変わったことを、キーボードや読み上げで使う人にも伝える
(confirming ? p.note : byName(defs[0] ? defs[0].n : "")[0] || p.next).focus({ preventScroll: true });
};
var value = function (d) {
var out = [];
byName(d.n).forEach(function (el) {
if (d.t === "file") { Array.prototype.forEach.call(el.files || [], function (f) { out.push(f.name); }); }
else if (d.t === "radio" || d.t === "checkbox") { if (el.checked) out.push(el.value); }
else if (String(el.value).trim() !== "") out.push(el.value);
});
return out.join("、");
};
EventTarget.prototype.addEventListener.call(form, "submit", function (e) {
if (E.getAttribute.call(form, "data-ccf-mode") === "confirm") { p.send.disabled = true; return; }
try {
// 必須のチェックボックスは required を付けられないので、ここで確かめる(サーバーでも確かめる)
for (var i = 0; i < defs.length; i++) {
var d = defs[i];
if (d.t !== "checkbox" || !d.r || value(d) !== "") continue;
var boxes = byName(d.n), first = boxes[0];
if (!first) continue;
e.preventDefault();
first.setCustomValidity("「" + d.l + "」を 1 つ以上選んでください。");
first.reportValidity();
boxes.forEach(function (el) { el.addEventListener("change", function () { first.setCustomValidity(""); }); });
return;
}
p.summary.textContent = "";
defs.forEach(function (d) {
var dt = document.createElement("dt"), dd = document.createElement("dd");
dt.textContent = d.l;
dd.textContent = value(d) || "(未入力)";
dd.style.whiteSpace = "pre-wrap";
p.summary.appendChild(dt); p.summary.appendChild(dd);
});
mode(true, true);
e.preventDefault();
} catch (err) {
// 確認画面を出せなければ、確認なしで送る(preventDefault しない)
}
});
p.back.addEventListener("click", function () { mode(false, true); });
window.addEventListener("pageshow", function (e) {
// 戻るボタンで戻ってきたとき(bfcache)に「送信する」が押せないままにならないように。
// 使用済みの Turnstile のトークンも残るので取り直す(そのまま送ると確認に失敗する)
p.send.disabled = false;
var ts = E.querySelector.call(form, ".cf-turnstile");
if (e.persisted && ts && window.turnstile) { try { window.turnstile.reset(ts); } catch (err) {} }
});
p.next.textContent = "入力内容を確認する";
mode(false, false);
})();
</script>
</form>
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>API で送る
埋め込みコードを使わず、サイトの画面から直接送るときの仕様です。本文は multipart/form-data・application/x-www-form-urlencoded・application/json のどれでも受け取り、結果は JSON で返します(Accept が text/html だけのときは HTML)。 送る側のサイトのアドレスを「送信を受け付けるサイト」に入れてください。 このフォームは Turnstile で確かめるので、送る画面にウィジェットを置き、返ってきた値を一緒に送ります(サーバー同士の送信には使えません)。
POSThttps://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m送る項目
| 項目名(送信のキー) | 表示名 | 種類 | 必須 | 値 |
|---|---|---|---|---|
お名前 | お名前 | 1 行の文字 | 必須 | |
email | メールアドレス | メールアドレス | 必須 | メールアドレスの形 |
ご用件 | ご用件 | プルダウン | 必須 | お見積もり / 資料請求 / その他(どれか 1 つ) |
本文 | お問い合わせ内容 | 複数行の文章 | 必須 | |
チェックボックス | チェックボックス | チェックボックス(複数選べる) | 必須 | テスト1 / テスト2 / テスト3 / テスト4 / テスト5 / テスト6(複数選ぶときは同じ項目名で繰り返す。JSON なら文字列の配列) |
_hp | ボット対策(人には見えない欄) | 内部用 | 任意 | 空のまま送る。値が入っているとスパムとして扱う(応答は成功) |
_ts | ボット対策(画面を開いた時刻) | 内部用 | 任意 | 画面を開いたときの Date.now()(ミリ秒)。送信までが 2 秒未満だとスパム寄りに見る |
cf-turnstile-response | Turnstile のトークン | 内部用 | 必須 | ウィジェットが返す値。1 回きりなので、送るたびに取り直す |
一覧に無い項目名で送っても受け取ります(確かめずに保存します)。項目名に使えるのは文字・数字と _ . - [ ] だけで、それ以外の名前は unnamed_1 のように付け替えます。
ブラウザから送る(fetch)
// 画面を開いたときに控えておく
const openedAt = Date.now();
// 送信するとき
const body = new FormData();
body.append("お名前", "テスト");
body.append("email", "taro@example.com");
body.append("ご用件", "お見積もり");
body.append("本文", "お問い合わせの内容");
body.append("チェックボックス", "テスト1");
body.append("_hp", ""); // 人には見えない入力欄の値(空のまま)
body.append("_ts", String(openedAt));
body.append("cf-turnstile-response", token); // Turnstile のウィジェットが返した値
const res = await fetch("https://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m", {
method: "POST",
headers: { Accept: "application/json" }, // Content-Type は付けない(ブラウザが付ける)
body,
});
const data = await res.json().catch(() => null);
if (res.ok && data?.ok) {
// 送れた(data.id は受付の ID)
} else {
// data.message があれば利用者に見せる文。無ければ data.error と res.status で出し分ける
}端末から試す(curl)
curl -H 'Accept: application/json' \ -F 'お名前=テスト' \ -F 'email=taro@example.com' \ -F 'ご用件=お見積もり' \ -F '本文=お問い合わせの内容' \ -F 'チェックボックス=テスト1' \ -F '_hp=' \ -F "_ts=$(($(date +%s)*1000-5000))" \ -F 'cf-turnstile-response=<ウィジェットが返した値>' \ 'https://cms.cross-chop.jp/f/4DWQD68vxWaykHJAPUi1m'
応答
| ステータス | 本文(JSON) | 意味 |
|---|---|---|
| 200 | { "ok": true, "id": "…" } | 受け付けた。スパムと見たものにも同じ応答を返す |
| 400 | { "ok": false, "error": "invalid field: …", "message": "「…」を入力してください。" } | 必須・選択肢・形の問題。message は利用者にそのまま見せられる文 |
| 400 | { "ok": false, "error": "captcha failed" } | Turnstile のトークンが無い・期限切れ・使用済み |
| 400 | { "ok": false, "error": "invalid body" } | 本文を読めない。ほかに項目・添付の大きさや数の問題(too many fields、field too large: …、file type not allowed: … など) |
| 403 | { "ok": false, "error": "origin not allowed" } | 「送信を受け付けるサイト」に無いオリジンから送った |
| 404 | { "ok": false, "error": "form not found" } | ID が違うか、受け付けを止めている |
| 413 | { "ok": false, "error": "payload too large" } | 全体で 30MB を超えた |
| 429 | { "ok": false, "error": "rate limited" } | 同じ IP から 1 分に 10 回を超えた(Retry-After: 60)。daily limit reached は、確かめていない送信の 1 日の上限 |
| 503 | { "ok": false, "error": "temporarily unavailable, retry later" } | 保存できなかった(届いていない)。時間をおいて送り直す。captcha unavailable, retry later も同じ |