POST/api/auth/forgot-password
このアドレスに該当するアカウントが存在する場合、パスワードリセット用のメール送信をトリガーします。アカウントの存在の有無に関わらず、常に同じ応答を返すため、アカウントの存在を推測することはできません。
「POST /api/auth/forgot-password — APIリファレンス」のページでは、URLで指定された機能領域について扱います。既存の内容には、実際の処理手順、前提条件、および既知の制限事項が追加されます。Zentorには開発者向けAPIキーシステムは存在しません。ダッシュボードでは、有効期間が12時間のセッションJWTと有効期間が7日のリフレッシュトークンが使用され、TOTPとSSOはオプションです。ウィジェット埋め込みトークンは一度だけ平文で表示され、許可されたオリジンにバインドされます。 `POST /api/auth/forgot-password`に関するドキュメントは、この具体的なエンドポイントの技術的な記述として拘束力を持って読み解かれるべきです。重要なのは、メソッド、パス、認証、必須フィールド、可能なエラー、および再呼び出しが同じ効果を引き起こすかどうかという点です。したがって、このヘルプセクション https://zentor-app.de/hilfe/api-referenz/auth/auth.forgot_password には一般的な宣伝文句を含めることはできず、その後に続く検証可能な統合手順と実証済みのレスポンス例のみを含める必要があります。 `/api/auth/forgot-password`を呼び出す場合、リクエストはレジストリに従って構築されます。公開ルートには一般的な開発者APIキーは必要ありません。Zentorはこのようなキーシステムを提供していないためです。一方、保護されたウィジェットルートでは、一度だけ表示される埋め込みトークンとオリジンチェックが使用されます。HTTPステータスとJSONコンテンツは一緒に評価されなければなりません。`ok`フィールドだけではエラー処理を代替できません。 `POST /api/auth/forgot-password`をテストする際は、匿名化された値を使用する必要があります。実際の顧客データ、本番環境のUUID、セッショントークン、および具体的なタイムスタンプは公開例に含まれてはいけません。プラットフォーム全体の既知の制限は15分以内に2,000リクエストです。これとは異なる個別の制限は証明されていません。非冪等なPOST呼び出しは、不明瞭なネットワーク切断後に盲目的に再試行してはいけません。 このルートにおける典型的な統合エラーは、必須パラメータの欠落、誤ったデータ型、期限切れのワンタイムコード、許可されていないオリジン、または未実装のデータセットによって引き起こされます。アプリケーションはこれらのケースを個別に処理し、エンドポイントから返されるエラーメッセージをログに記録する必要がありますが、機密情報は記録してはいけません。成功したリクエストは、その処理ステップのみを確認するものであり、直後に付随するメール、決済、またはSSOの成功を自動的に意味するものではありません。これは「POST /api/auth/forgot-password」にとって直接的に関連する事項です。 このページの技術的な検証は、`app/frontend/src/content/api-reference/` 内のレジストリおよび関連するバックエンドルートに依存して行われなければなりません。ライブテストの注記は、実際に検証されたことのみを主張すべきです。ネガティブテストやコードの類似性は、完全な成功の証明にはなりません。したがって、「POST /api/auth/forgot-password — APIリファレンス」については、文書化された構造、自動テスト、および安全に観察されたライブ動作を明確に区別する必要があります。
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Ja
Parameter
email(body, string, erforderlich)— アカウントのメールアドレスBeispiel-Request
{"email":"user@example.com"}Beispiel-Response
{"ok":true}Fehlercodes
400 VALIDATION_ERROR — Eメールフィールドが不足しているか、空です。Live-Test-Nachweis
成功(200、アカウントの有無に関わらず中立なレスポンス)とネガティブケース(フィールド不足の場合400)をライブで検証済み。