テスト2
公開 ID: dGqXINnVCAlMEvmfQmkGZ
設定
サイトに組み込むための情報(制作担当者向け)埋め込みコード、確認用のフォーム、API の仕様
埋め込みコード
サイトの HTML に貼ると、このフォームに送信できます。ボット対策の行は消さないでください。 「送信を受け付けるサイト」が空なので、どのサイトからでも送れます。フォームを置くサイトのアドレスを入れてください。
確認用のフォームを開く(同じ項目のフォームを開いて、試しに送れます。送った内容は「お問い合わせ」に届きます)
送信先:
https://cms.cross-chop.jp/f/dGqXINnVCAlMEvmfQmkGZ<form action="https://cms.cross-chop.jp/f/dGqXINnVCAlMEvmfQmkGZ" method="POST" enctype="multipart/form-data"> <label>お名前 * <input type="text" name="お名前" required></label> <label>メールアドレス * <input type="email" name="email" required></label> <label>お問い合わせ内容 * <textarea name="本文" required></textarea></label> <!-- ボット対策(消さない)。人には見えない欄と、ページを開いた時刻 --> <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">送信</button> </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/dGqXINnVCAlMEvmfQmkGZ送る項目
| 項目名(送信のキー) | 表示名 | 種類 | 必須 | 値 |
|---|---|---|---|---|
お名前 | お名前 | 1 行の文字 | 必須 | |
email | メールアドレス | メールアドレス | 必須 | メールアドレスの形 |
本文 | お問い合わせ内容 | 複数行の文章 | 必須 | |
_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("_hp", ""); // 人には見えない入力欄の値(空のまま)
body.append("_ts", String(openedAt));
body.append("cf-turnstile-response", token); // Turnstile のウィジェットが返した値
const res = await fetch("https://cms.cross-chop.jp/f/dGqXINnVCAlMEvmfQmkGZ", {
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 '_hp=' \ -F "_ts=$(($(date +%s)*1000-5000))" \ -F 'cf-turnstile-response=<ウィジェットが返した値>' \ 'https://cms.cross-chop.jp/f/dGqXINnVCAlMEvmfQmkGZ'
応答
| ステータス | 本文(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 も同じ |