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`을 호출하려면 요청을 레지스트리에 따라 구성해야 합니다. 공개 라우트는 Zentor가 이러한 키 시스템을 제공하지 않기 때문에 일반적인 개발자 API 키가 필요하지 않습니다. 반면 보호된 위젯 라우트는 한 번만 표시되는 임베드 토큰과 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":"상담 요청이 전송되었습니다. 곧 연락드리겠습니다."}