POST/api/public/consultation

Zentorのウェブサイトにおける公開相談リクエストフォーム。

ページ「POST /api/public/consultation — APIリファレンス」は、URLで指定された機能領域を扱います。既存の内容は、実際の処理手順、前提条件、および既知の制限事項によって補完されます。フォームビルダーは、トリガーキーワード、フィールドタイプ、必須フィールドの指定を自由に設定可能なフォームをサポートしています。この機能はE2Eテスト済みです。 `POST /api/public/consultation` のドキュメントは、この特定のエンドポイントの技術的な説明として読み取る必要があります。重要なのは、メソッド、パス、認証、必須フィールド、可能なエラー、および再呼び出しが同じ効果を引き起こすかどうかという点です。したがって、以下のURL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation には一般的な宣伝文句を含めることはできず、再現可能な統合手順と実証済みのレスポンス例のみを含める必要があります。 `/api/public/consultation` を呼び出す場合、リクエストはレジストリに従って構築されます。公開ルートには一般的な開発者用APIキーは必要ありません。Zentorはこのようなキーシステムを提供していないためです。一方、保護されたウィジェットルートでは、一度だけ表示される埋め込みトークンとOriginチェックを使用します。HTTPステータスとJSONコンテンツは一緒に評価する必要があります。`ok`フィールドだけではエラー処理を代替できません。 `POST /api/public/consultation` のテストでは、匿名化された値を使用する必要があります。実際の顧客データ、本番環境のUUID、セッショントークン、および具体的なタイムスタンプは公開例に含めるべきではありません。プラットフォーム全体の既知の制限は、15分以内に2,000リクエストです。これとは異なる個別の制限は証明されていません。非冪等なPOST呼び出しは、不明瞭なネットワーク切断後に盲目的に再試行してはいけません。 このルートにおける典型的な統合エラーは、必須パラメータの欠落、誤ったデータ型、期限切れのワンタイムコード、許可されていないOrigin、または事前に存在しないレコードによって引き起こされます。アプリケーションはこれらのケースを個別に処理し、エンドポイントから返されるエラーメッセージをログに記録する必要がありますが、機密情報は記録しないでください。リクエストの成功は、その処理ステップの確認のみを示し、必ずしも後続のメール、支払い、またはSSOの成功を保証するものではありません。これは「POST /api/public/consultation」にとって直接的に関連する事項です。 このページの技術的な検証は、`app/frontend/src/content/api-reference/` 内のレジストリおよび関連するバックエンドルートに厳密に従うべきです。ライブテストの注記は、実際に検証されたことのみを主張すべきです。ネガティブテストやコードの類似性は、完全な成功の指示にはなりません。したがって、「POST /api/public/consultation — APIリファレンス」については、文書化された構造、自動化されたテスト、および安全に観察されたライブ動作を明確に区別する必要があります。

{"name":"マックス・ムスターマン","email":"max@example.com","company":"ムスターファーム","message":"ご要望","consentGiven":true}

{"ok":true,"message":"ご相談内容が送信されました。近日中にご連絡いたします。"}