오류 레퍼런스

모든 Seizn API 오류 코드와 해결 가이드에 대한 전체 레퍼런스

표시 중 8 / 8 오류 코드

오류 응답 형식

모든 Seizn API 오류는 디버깅에 유용한 정보가 포함된 일관된 형식을 따릅니다:

{
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Invalid API key",
    "trace_id": "trc_abc123xyz",
    "request_id": "req_456def",
    "suggested_fix": "Check your API key in Dashboard...",
    "docs_url": "https://seizn.com/docs/api/authentication"
  }
}

더 빠른 해결을 위해 지원팀에 문의할 때 항상 trace_id를 포함하세요.

인증 오류

API 키 및 인증 관련 오류

AUTH_MISSING_KEYHTTP 401

Missing API Key

권장 해결 방법: Add x-api-key header with your API key

AUTH_INVALID_KEYHTTP 401

Invalid API Key

권장 해결 방법: Check your API key in Dashboard → API Keys

AUTH_EXPIRED_KEYHTTP 401

Expired API Key

권장 해결 방법: Generate a new API key from the dashboard

속도 제한 오류

속도 제한 및 할당량 관련 오류

RATE_LIMITEDHTTP 429

Rate Limited

권장 해결 방법: Implement exponential backoff (1s → 2s → 4s)

QUOTA_EXCEEDEDHTTP 429

Quota Exceeded

권장 해결 방법: Upgrade your plan or wait for quota reset

유효성 검사 오류

잘못된 요청 형식 또는 데이터 관련 오류

INVALID_INPUTHTTP 400

Invalid Input

권장 해결 방법: Check request body against API documentation

리소스 오류

리소스를 찾을 수 없는 오류

NOT_FOUNDHTTP 404

Not Found

권장 해결 방법: Verify the resource ID exists and is accessible

서버 오류

예기치 않은 서버 오류

INTERNAL_ERRORHTTP 500

Internal Error

권장 해결 방법: Retry the request; contact support if it persists

추가 도움이 필요하신가요?

더 빠른 디버깅을 위해 모든 지원 요청에 trace_id를 포함하세요
서비스 상태 및 예정된 유지보수는 status.seizn.com을 확인하세요
속도 제한 및 외부 서비스 오류에 대해 지수 백오프로 재시도하세요
지속적인 문제는 [email protected]으로 문의하세요