응답 형식

공통 응답 봉투와 오류 처리 안내

이 문서는 파트너 서버 API의 공통 응답 형식을 설명해요.

모든 응답은 공통 봉투(envelope)로 감싸져요.

성공:

{"resultType": "SUCCESS", "success": { ... }}

실패:

{"resultType": "FAIL", "success": null, "error": {"errorType": 0, "errorCode": "4010", "reason": "...", "data": {}, "title": null}}

비즈니스 오류는 HTTP 200으로 응답해요. resultType이 SUCCESS인지 확인하고, SUCCESS가 아닌 값은 모두 실패로 처리하세요. 요청 형식 오류(필드 검증 실패)는 HTTP 400, 분류되지 않은 서버 오류는 HTTP 500으로 응답해요. 요청 한도를 초과하면 HTTP 200에 errorCode: "4095"와 error.data.retryAfterSeconds가 내려가요.