POST/api/public/contact

Zentor Webサイトの公開お問い合わせフォーム。内部リードシステムに問い合わせを作成します。

`POST /api/public/contact` は Zentor 社の Web サイトの公開お問い合わせフォームを処理し、リクエストを内部のリード管理システムに記録します。このエンドポイントはダッシュボードの認証を必要とせず、冪等ではありません。各成功した送信は新しいリードを生成する可能性があります。そのため、フロントエンドは最初のクリック後に送信ボタンを無効化し、自動的な再送信を引き起こしてはいけません。 確認済みの必須フィールドには `name`、`email`、`message` が含まれます。名前は 2 文字から 120 文字の範囲である必要があり、メールアドレスは有効な形式を持っている必要があり、メッセージはサーバー側のバリデーションルールを満たす必要があります。他のフィールドは、実際のスキーマで定義されている場合のみ送信してください。未知の値を使用して、リードの内部プロパティを制御しないでください。 正しいフォームは、ブラウザ内で必須フィールドのチェックをすでに行っていますが、そのチェックだけに依存してはいけません。サーバー側の検証が最終的な判断を行います。バリデーションエラーが発生した場合、UI は該当するフィールドをマークし、入力された内容を保持する必要があります。サーバーからの肯定的な応答が得られて初めて、一般的な成功メッセージを表示してください。 お問い合わせフォームは、パスワード、API キー、ウィジェットトークン、決済データ、または完全な顧客レコードを送信するための安全なチャネルではありません。ユーザーは、利用目的、対象製品、および連絡可能なビジネス用メールアドレスを記載する必要があります。技術的な問題については、テナント名、発生時刻、影響を受けた機能、再現手順を記載することで、不要な個人情報を送信することなく支援を受けることができます。 現実的なフローは以下の通りです。訪問者が氏名、メールアドレス、メッセージを入力し、必要に応じてサイトのプライバシーポリシーに同意してフォームを送信します。サーバーはデータを検証し、リードを作成して成功応答を返します。メールアドレスが無効または名前が短すぎる場合、完全なリードは生成されません。このエンドポイントはテナントを作成せず、パッケージの予約も行わず、構造化された製品設定やコンサルティングプロセスを代替するものではありません。 スパムや自動的な連続リクエストから保護するため、クライアントはサーバー側のエラーを尊重し、即時の無限ループを開始しないでください。成功応答が得られた場合に限り、入力フィールドを空にしてください。応答がない場合、ユーザーは内容を一時的に保存し、後で制御された方法で再送信することができます。 内部割り当てのため、メッセージにはマーケティングの決まり文句や機密性の高い添付ファイルを含めず、実際の事由を記載してください。明確な件名と正確な問題説明は、問い合わせの回数を減らすのに役立ちます。ただし、API 自体は優先順位を保証するものではなく、決まった処理期間を確認するものでもありません。

{"name":"Max Mustermann","email":"max@example.com","message":"あなたのメッセージ（最低10文字）。","consentGiven":true}

{"ok":true,"message":"リクエストが送信されました。"}