CROSSCHOP CMS

テスト2

公開 ID: dGqXINnVCAlMEvmfQmkGZ

設定

項目

サイトのフォームに並ぶ項目です。送信が届いたときに、必須・選択肢・入力の形をこの一覧で確かめます。 項目名はサイトのフォームと同じ名前にします(自動返信の本文で {{項目名}} と書くときにも使います)。項目名や選択肢を変えると、サイトからの送信が合わなくなることがあるので、変えるときはサイトの制作担当者に連絡してください。 項目を 1 つも置かないと、送られた項目をそのまま受け取ります(確かめはしません)。

お問い合わせした方のメールアドレスには、種類が「メールアドレス」の最初の項目を使います(自動返信の宛先になります)。

「入力内容を確認する」で入力した内容を一覧で見せ、「修正する」「送信する」を選んでもらいます。埋め込みコードに入るので、変えたらサイトに貼り直してください

自動で送りつけるプログラムからの送信を防ぎます。切ると、添付ファイルと自動返信が使えなくなり、1 日に保存できる件数に上限がかかります

お問い合わせした方が入力したメールアドレスに、受け付けた旨のメールを 1 通送ります。本文は文字だけで、{{項目名}} と書いた所に入力内容が入ります(URL に読める部分は「(省略)」になります)

入れると、届いてから保存日数を過ぎたお問い合わせを、添付ごと毎日自動で削除します(元に戻せません)。入れなければ、削除するまで残ります

サイトに組み込むための情報(制作担当者向け)埋め込みコード、確認用のフォーム、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-responseTurnstile のトークン内部用必須ウィジェットが返す値。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 も同じ