일반 오류 코드
SilentShield API에서 반환하는 모든 오류 코드에 대한 빠른 참조입니다.
| Status | Error | Description | Solution |
|---|---|---|---|
400 | invalid_request | 잘못된 요청 본문이거나 필수 필드가 누락되었습니다. | 요청 형식이 API 문서와 일치하는지 확인하세요. |
401 | missing credentials | 요청에 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 헤더에 재시도 가능 시점이 표시됩니다. |
429 | domain_not_verified_limit | 미인증 도메인이 하루 100건의 테스트 모드 제한을 초과했습니다. | 도메인을 인증하여 전체 할당량을 사용하세요. |