오류 코드 - LexQ Docs

오류 응답 형식

모든 오류는 일관된 envelope을 따릅니다:

{
  "result": "ERROR",
  "data": null,
  "code": "P-001",
  "message": "Policy group not found."
}

공통 (C)

코드	HTTP	설명
`C-001`	400	입력값이 올바르지 않습니다
`C-002`	405	허용되지 않은 HTTP 메서드
`C-003`	404	요청한 리소스를 찾을 수 없습니다
`C-004`	500	서버 내부 오류
`C-005`	400	데이터 타입이 올바르지 않습니다
`C-006`	409	이미 존재하는 리소스
`C-007`	429	요청량 초과 (TPS 한도)

인증 (A)

코드	HTTP	설명
`A-001`	401	인증 실패
`A-002`	403	접근 권한 없음
`A-003`	401	유효하지 않은 API 키
`A-004`	409	이미 가입된 이메일
`A-005`	409	API 키 최대 개수 초과
`A-006`	401	이메일 또는 비밀번호 오류

정책 엔진 (P)

코드	HTTP	설명
`P-001`	404	정책 그룹을 찾을 수 없습니다
`P-002`	404	정책 버전을 찾을 수 없습니다
`P-003`	400	정책 실행 중 오류 발생
`P-004`	400	승인되지 않은 정책 버전
`P-005`	404	정책 규칙을 찾을 수 없습니다
`P-006`	400	현재 상태에서 수정 불가 (DRAFT만 수정 가능)
`P-007`	400	규칙 없이 발행 불가
`P-008`	400	현재 상태에서 수행할 수 없는 작업
`P-009`	403	정책 그룹이 비활성화(DISABLED) 상태
`P-010`	400	규칙 순서 변경 ID 불일치
`P-013`	400	롤백할 이전 버전이 없음
`P-014`	404	배포 이력을 찾을 수 없습니다
`P-015`	400	실행 요청에 필수 팩트 누락

결제 (B)

코드	HTTP	설명
`B-001`	404	요금제를 찾을 수 없습니다
`B-002`	404	구독 정보를 찾을 수 없습니다
`B-003`	409	이미 사용 중인 구독 존재
`B-004`	400	현재 상태에서 수행할 수 없는 작업
`B-005`	404	청구서를 찾을 수 없습니다
`B-006`	500	해당 통화를 지원하는 결제 프로세서 없음
`B-007`	502	결제 처리 실패
`B-008`	403	서비스 사용 한도 초과
`B-009`	400	무료 플랜은 해지 불가

분석 (AN)

코드	HTTP	설명
`AN-001`	500	시뮬레이션 처리 실패
`AN-002`	404	데이터셋을 찾을 수 없습니다
`AN-003`	400	데이터셋이 너무 큽니다
`AN-004`	400	데이터셋에 레코드 없음
`AN-005`	400	데이터셋 형식 오류
`AN-009`	404	시뮬레이션을 찾을 수 없습니다
`AN-010`	400	PENDING 또는 RUNNING 시뮬레이션만 취소 가능
`AN-011`	400	완료된 시뮬레이션만 내보내기 가능

액션 (ACT)

코드	HTTP	설명
`ACT-001`	400	액션 파라미터가 비어있습니다
`ACT-002`	400	참조 변수 `refVar` 필수
`ACT-003`	400	잘못된 계산 방식 (허용: PERCENTAGE, AMOUNT)
`ACT-004`	400	PERCENTAGE 방식에 rate 파라미터 필수
`ACT-005`	400	AMOUNT 방식에 value 파라미터 필수
`ACT-006`	400	잘못된 액션 타입
`ACT-007`	400	할인율은 0~100 사이여야 합니다
`ACT-008`	400	포인트 적립률은 0~100 사이여야 합니다
`ACT-009`	400	외부 서비스 액션에 Integration ID 필수

팩트 정의 (FD)

코드	HTTP	설명
`FD-001`	409	팩트 키가 이미 존재합니다
`FD-002`	404	팩트를 찾을 수 없습니다
`FD-003`	403	시스템 팩트는 수정/삭제 불가
`FD-004`	400	잘못된 팩트 키 형식

연동 (INT)

코드	HTTP	설명
`INT-001`	404	연동을 찾을 수 없습니다
`INT-002`	409	연동 이름 중복
`INT-003`	400	잘못된 연동 설정

장애 로그 (FL)

코드	HTTP	설명
`FL-001`	404	장애 로그를 찾을 수 없습니다
`FL-002`	400	잘못된 장애 로그 액션
`FL-003`	400	해당 유형은 재시도를 지원하지 않음

멱등성 (I)

코드	HTTP	설명
`I-001`	409	이미 처리된 요청 (중복 멱등키)
`I-002`	409	현재 처리 중인 요청

멤버 (M)

코드	HTTP	설명
`M-001`	404	사용자 정보를 찾을 수 없습니다
`M-002`	403	이메일 인증이 필요합니다
`M-003`	403	정지된 계정
`M-004`	403	탈퇴한 계정
`M-005`	400	유효하지 않거나 만료된 인증 코드

개요

정책 실행

​오류 응답 형식

​공통 (C)

​인증 (A)

​정책 엔진 (P)

​결제 (B)

​분석 (AN)

​액션 (ACT)

​팩트 정의 (FD)

​연동 (INT)

​장애 로그 (FL)

​멱등성 (I)

​멤버 (M)

오류 응답 형식

공통 (C)

인증 (A)

정책 엔진 (P)

결제 (B)

분석 (AN)

액션 (ACT)

팩트 정의 (FD)

연동 (INT)

장애 로그 (FL)

멱등성 (I)

멤버 (M)