일반 오류 코드

SilentShield API에서 반환하는 모든 오류 코드에 대한 빠른 참조입니다.

Status	Error	Description	Solution
`400`	`validation_error`	잘못된 요청 본문이거나 필수 필드가 누락되었습니다.	요청 형식이 API 문서와 일치하는지 확인하세요.
`401`	`missing_api_key`	요청에 API 키가 누락되었습니다.	요청에 X-Api-Key 헤더를 추가하세요.
`403`	`ip_not_whitelisted`	클라이언트 IP가 보안 정책 화이트리스트에 없습니다.	대시보드 → 보안 정책에서 IP를 화이트리스트에 추가하세요.
`403`	`ip_blacklisted`	클라이언트 IP가 보안 정책 블랙리스트에 있습니다.	대시보드 → 보안 정책에서 IP를 블랙리스트에서 제거하세요.
`403`	`domain_mismatch`	요청의 Origin/Referer 도메인이 API 키의 도메인과 일치하지 않습니다.	대시보드 → API 키 → 편집에서 도메인을 업데이트하세요.
`403`	`referer_not_allowed`	리퍼러 도메인이 허용된 리퍼러 목록에 없습니다.	보안 정책의 허용된 리퍼러에 도메인을 추가하세요.
`429`	`quota_exceeded`	월간 요청 할당량이 초과되었습니다.	플랜을 업그레이드하거나 할당량이 초기화될 때까지 기다리세요.
`429`	`ip_rate_limited`	IP당 속도 제한에 도달했습니다.	60초 동안 기다리세요. Retry-After 헤더에 재시도 가능 시점이 표시됩니다.
`200`	`X-Domain-Test-Limit-Exceeded`	확인되지 않은 도메인: 테스트 모드에서 하루 10건을 초과한 요청. 요청은 거부되지 않으며, 헤더 X-Domain-Test-Limit-Exceeded 로만 알립니다.	도메인을 인증하여 전체 할당량을 사용하세요.
`403`	`suspicious`	실제 방문자가 /v1/verify에서 판정 suspicious와 NO_TYPING_PAUSES 같은 사유로 거부됩니다. 위젯이 제출을 받지 못한 것입니다. 예를 들어 폼이 submit 이벤트 없이 버튼 클릭과 AJAX로 전송되는 경우입니다.	behavior_nonce 필드를 요청 본문에 포함하세요(폼 전체를 숨김 필드까지 직렬화합니다). XMLHttpRequest로 만든 요청은 jQuery.ajax를 포함하여 SilentShield 2.6부터 위젯이 보고합니다. fetch()로 만든 요청은 아직 보고되지 않습니다. 일반 폼 제출을 사용하거나 지원팀에 문의하세요.