Support & Inquiry API

서비스 문의 접수와 운영 지원에 사용하는 엔드포인트입니다.

엔드포인트 목록

메서드	경로	설명	인증
POST	/api/inquiries	문의 등록	필요

---

POST /api/inquiries

로그인 사용자의 문의 내용을 등록합니다. 프론트엔드는 /contact/form 페이지에서 Form을 제공하고, 제출 요청은 BFF apps/web/src/app/api/inquiries/route.ts를 통과합니다.

Request Body

{
  "title": "계정 로그인 오류",
  "content": "문의 상세 내용",
  "contactEmail": "[email protected]"
}

필드	타입	제약
title	string	필수, 최대 100자
content	string	필수, 최대 2000자
contactEmail	string	필수, 이메일 형식

Response

성공 시 201 Created와 함께 등록된 문의 요약 정보를 반환합니다.

{
  "success": true,
  "data": {
    "id": 1,
    "title": "계정 로그인 오류",
    "createdAt": "2026-06-25T00:00:00Z"
  },
  "error": null
}

BFF 보안 정책

• 로그인 필요: authenticatedBackendFetch 사용
• CSRF Origin 검증 적용: withApiGuards({ requireCsrf: true })
• Turnstile 미적용

주요 실패 응답

상황	HTTP	코드
로그인 필요	401	LOGIN_REQUIRED
잘못된 요청 본문	400	INVALID_REQUEST_BODY
Origin 누락 또는 불일치	403	CSRF_ORIGIN_REQUIRED, CSRF_ORIGIN_MISMATCH
백엔드 문의 등록 실패	백엔드 status 유지	INQUIRY_CREATE_FAILED