API 참조

이 레퍼런스는 실제로 존재하며 공개적으로 사용할 수 있는 JSON 엔드포인트만 설명합니다 -- 엔드포인트별 메서드, 경로, 인증 유형, 필수 매개변수, 요청 및 응답 예시, 문서화된 오류 코드가 포함됩니다. Zentor에는 일반적인 개발자용 API 키 시스템이 없습니다. 액세스는 경로에 따라 인증 없이 이루어지거나 Origin 검증이 포함된 위젯 임베드 토큰을 통해 이루어집니다. 내부 대시보드 경로와 Master Admin 엔드포인트는 일반 로그인 세션을 통해서만 접근할 수 있으므로 의도적으로 이 공개 레퍼런스에서 제외되었습니다.

각 엔드포인트 항목에는 해당 정보가 레지스트리 스키마, 자동화된 테스트 또는 실제 라이브 관찰 중 어디에서 나온 것인지 밝히는 라이브 테스트 메모가 붙어 있습니다 -- 정상 동작하는 코드 경로와 단순히 유사하다는 것만으로는 완전한 증거로 간주되지 않습니다. 또한 기술적으로 성공한 호출은 항상 해당 요청 자체의 처리만 확인할 뿐, 이메일 전송, 결제 완료 또는 SSO 로그인 완료와 같은 후속 과정까지 자동으로 확인하지는 않습니다.

보안 방식은 각 그룹에 따라 다릅니다. 공개 법률, 마케팅 및 양식 엔드포인트에는 대시보드 세션이 필요하지 않습니다. 반면 채팅 위젯은 `X-Widget-Token` 헤더와 Origin 허용 목록을 사용합니다. 대시보드 로그인 시에는 유효 기간이 12시간인 세션 JWT와 7일간 유효한 리프레시 토큰이 발급됩니다. SSO 엔드포인트는 자체 일회용 코드와 콜백 흐름으로 작동합니다.

각 엔드포인트 페이지를 독립적인 계약으로 읽으십시오. 중요한 것은 HTTP 메서드, 경로, 필수 매개변수, 데이터 유형, 요청 본문, 응답 구조, 오류 코드 및 멱등성입니다. 예시는 가능한 형식 하나를 보여 줄 뿐이며 실제 응답에 대한 확인을 대신하지 않습니다. 구성 상태, 유효성 검사, 권한 및 외부 제공업체에 따라 결과가 달라질 수 있습니다.

확인된 플랫폼 전체 요청 한도(Rate Limit)는 15분당 2,000건입니다. 엔드포인트별 개별 한도는 일관되게 문서화되어 있지 않습니다. 따라서 클라이언트는 불필요하게 짧은 간격의 폴링 루프를 사용하지 않아야 합니다. 멱등성이 없는 작업에서는 자동 재시도로 인해 레코드나 메시지가 중복 생성될 수 있습니다.

민감한 값은 로그에 남기지 않아야 합니다. 여기에는 비밀번호, 재설정 토큰, 인증 코드, 위젯 토큰, 세션 ID 및 실제 개인정보가 포함된 예시 데이터가 해당됩니다. 문서와 테스트에는 익명화된 값을 사용하십시오. 라이브 테스트 메모는 실제 증거를 정확하게 반영해야 합니다.