npm - @cmarket/partner-sdk - Versions diffs - 43.0.2 → 44.1.0 - Mend

@cmarket/partner-sdk 43.0.2 → 44.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (894) hide show

package/docs/PartnerApiApi.md CHANGED Viewed

@@ -94,10 +94,10 @@ const { status, data } = await apiInstance.cancelBid(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 공고 취소 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -161,10 +161,10 @@ const { status, data } = await apiInstance.completeAcceptance(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 검수완료 처리 결과. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -228,10 +228,10 @@ const { status, data } = await apiInstance.completeFileUpload(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 업로드 확정 완료. 이제 &#x60;fileKey&#x60;를 공고 등록·수정의 첨부 필드에 실을 수 있습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -291,10 +291,10 @@ const { status, data } = await apiInstance.completeInvoice(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 정산 마감 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -355,10 +355,10 @@ const { status, data } = await apiInstance.createCardPayment(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 결제창 발행 완료. 반환된 주소로 결제자를 보내면 됩니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -419,10 +419,10 @@ const { status, data } = await apiInstance.createExternalContractDocuments(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 계약서류 생성 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -483,10 +483,10 @@ const { status, data } = await apiInstance.createFileUploadUrl(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 업로드 주소 발급 완료. 이 주소로 파일 본문을 직접 PUT 한 뒤 반드시 확정(2/2)을 호출해야 &#x60;fileKey&#x60;가 유효해집니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -547,10 +547,10 @@ const { status, data } = await apiInstance.createWebhookEndpoint(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 구독 등록 완료. &#x60;secret&#x60;은 이 응답에만 실립니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -613,10 +613,10 @@ void (empty response body)
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**204** | 구독 삭제 완료(본문 없음). |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**412** | &#x60;If-Match&#x60; 값이 현재 리소스와 다름(&#x60;…/precondition-failed&#x60;). 다시 조회해 최신 &#x60;ETag&#x60;로 재시도합니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**428** | &#x60;If-Match&#x60; 헤더 누락(&#x60;…/if-match-required&#x60;). |  -  |
@@ -1551,10 +1551,10 @@ const { status, data } = await apiInstance.markBidFailed(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 유찰 처리 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1618,10 +1618,10 @@ const { status, data } = await apiInstance.registerAward(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 낙찰 등록 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1682,10 +1682,10 @@ const { status, data } = await apiInstance.registerBid(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 공고 등록 완료. 발급된 &#x60;bidId&#x60;(c-market 공고번호)와 보낸 &#x60;purchaseNo&#x60;를 함께 돌려주므로 이후 조회에 어느 쪽을 써도 됩니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1746,10 +1746,10 @@ const { status, data } = await apiInstance.registerSemoContract(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 외부 계약 등록 완료. 동결 표면이라 &#x60;{data}&#x60; 봉투를 씌우지 않습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1813,10 +1813,10 @@ const { status, data } = await apiInstance.requestInvoiceSplit(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 청구 접수 결과. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1880,10 +1880,10 @@ const { status, data } = await apiInstance.revertAward(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 낙찰 되돌리기 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -1943,10 +1943,10 @@ const { status, data } = await apiInstance.rotateWebhookSecret(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 시크릿 재발급 완료. &#x60;secret&#x60;은 이 응답에만 실립니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -2006,10 +2006,10 @@ const { status, data } = await apiInstance.sendWebhookTestEvent(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 연결 확인 발송 결과. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
@@ -2076,10 +2076,10 @@ const { status, data } = await apiInstance.updateBid(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 공고 수정 완료. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**412** | &#x60;If-Match&#x60; 값이 현재 리소스와 다름(&#x60;…/precondition-failed&#x60;). 다시 조회해 최신 &#x60;ETag&#x60;로 재시도합니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**428** | &#x60;If-Match&#x60; 헤더 누락(&#x60;…/if-match-required&#x60;). |  -  |
@@ -2148,10 +2148,10 @@ const { status, data } = await apiInstance.updateWebhookEndpoint(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 수정된 웹훅 구독. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**412** | &#x60;If-Match&#x60; 값이 현재 리소스와 다름(&#x60;…/precondition-failed&#x60;). 다시 조회해 최신 &#x60;ETag&#x60;로 재시도합니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**428** | &#x60;If-Match&#x60; 헤더 누락(&#x60;…/if-match-required&#x60;). |  -  |
@@ -2214,10 +2214,10 @@ const { status, data } = await apiInstance.uploadFile(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**201** | 업로드 완료. 받은 &#x60;fileKey&#x60;를 공고 등록·수정의 첨부 필드에 실으세요. 같은 파일을 여러 공고에 재사용할 수 있습니다. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**413** | 요청 본문 크기 초과(&#x60;…/payload-too-large&#x60;). |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |

package/docs/PreliminaryPriceRegionPublic.md ADDED Viewed

@@ -0,0 +1,13 @@
+# PreliminaryPriceRegionPublic
+예비가격 범위(공개값). 미설정이면 null.
+## Enum
+* `PlusMinus2` (value: `'PLUS_MINUS_2'`)
+* `PlusMinus3` (value: `'PLUS_MINUS_3'`)
+* `PlusMinus4` (value: `'PLUS_MINUS_4'`)
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ProblemDetailsDto.md CHANGED Viewed

@@ -14,6 +14,7 @@ Name | Type | Description | Notes
 **traceId** | **string** | 요청 추적 id — &#x60;X-Correlation-Id&#x60; 응답 헤더와 같은 값입니다. 문의할 때 이 값을 첨부하세요. | [optional] [default to undefined]
 **correlationId** | **string** | &#x60;traceId&#x60;와 같은 값의 옛 이름입니다. 기존 연동 호환으로 함께 실립니다 — 새 연동은 &#x60;traceId&#x60;를 읽으세요. | [optional] [default to undefined]
 **invalid_params** | [**Array&lt;InvalidParamDto&gt;**](InvalidParamDto.md) | RFC 9457 확장 — 검증 실패(400 &#x60;…/validation-failed&#x60;) 시 위반 필드 경로 목록(값 없음). 그 외 에러엔 부재. | [optional] [default to undefined]
+**code** | **string** | 조달플랫폼이 요청을 거부한 **사유 코드**입니다. &#x60;type&#x60;은 상태 수준(예: &#x60;…/upstream-invalid-input&#x60;)이라 무엇을 고쳐야 하는지까지는 담지 못하고, &#x60;detail&#x60;은 내부 문구 노출을 막기 위해 고정 토큰입니다 — 그 사이를 이 필드가 메웁니다. 값은 안정 식별자라 문자열로 분기해도 됩니다. &#x60;…/upstream-*&#x60; 응답에만 실리며, 전달 대상으로 등재되지 않은 사유는 이 필드 없이 내려갑니다. | [optional] [default to undefined]
 ## Example
@@ -30,6 +31,7 @@ const instance: ProblemDetailsDto = {
     traceId,
     correlationId,
     invalid_params,
+    code,
 };
 ```

package/docs/ProductsApi.md CHANGED Viewed

@@ -59,10 +59,10 @@ const { status, data } = await apiInstance.acknowledgeProductReceipt(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 수신확인 결과. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60;). |  -  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;), &#x60;Idempotency-Key&#x60; 누락·형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 요청 내용 오류(&#x60;…/upstream-invalid-input&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;…/missing-bearer-token&#x60;), 만료·위변조·폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;…/unbound-partner-key&#x60;), IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60;), 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
-|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**409** | 같은 &#x60;Idempotency-Key&#x60;의 원 요청이 처리 중(&#x60;…/idempotency-key-conflict&#x60;), 또는 현재 상태와 충돌(&#x60;…/upstream-conflict&#x60; — 사유는 &#x60;code&#x60; 필드로 함께 옵니다). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
 |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. |  -  |
 |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
 |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |

package/docs/UpdateBidRequestDto.md CHANGED Viewed

@@ -11,7 +11,7 @@ Name | Type | Description | Notes
 **disclosePlannedAmount** | **boolean** | 예정금액(예산) 공개 여부. | [optional] [default to undefined]
 **attachments** | [**Array&lt;BidAttachmentInputDto&gt;**](BidAttachmentInputDto.md) | 공고 첨부파일 목록. 원소마다 &#x60;fileKey&#x60;(이미 올린 파일) · &#x60;url&#x60; · &#x60;base64&#x60; 중 **하나**를 담습니다. &#x60;url&#x60;·&#x60;base64&#x60;를 쓰면 별도 업로드 호출 없이 이 요청 하나로 끝납니다. 큰 파일이나 여러 공고에 재사용할 파일은 &#x60;POST /v2/files/upload-url&#x60;로 먼저 올리고 &#x60;fileKey&#x60;로 참조하세요. | [optional] [default to undefined]
 **items** | [**Array&lt;BidItemDto&gt;**](BidItemDto.md) | 품목 목록(1개 이상). | [optional] [default to undefined]
-**totalBudget** | **number** | 총 예산금액(원). items 합계 대신 별도 totalBudget으로 override 할 때 사용. | [optional] [default to undefined]
+**totalBudget** | **number** | 총 예산금액(원, **부가세 포함**). 생략하면 품목 합계(단가 × 수량)가 배정예산이 됩니다. 낙찰금액도 부가세 포함 금액이라 두 값은 같은 축입니다 — 공급가액(부가세 별도)을 보내면 절감액이 실제보다 크게 계산됩니다. (&#x60;/v1&#x60;은 이 필드를 부가세 **별도**로 받아 서버가 10%를 가산합니다. 두 표면의 축이 다르므로 v1에서 옮겨올 때 값을 그대로 쓰지 마세요.) | [optional] [default to undefined]
 **awardMethod** | **string** | 낙찰 방법(필수). LOWEST_PRICE&#x3D;최저가, APPROPRIATE_PRICE&#x3D;적정가, HIGHEST_PRICE&#x3D;최고가, MAX_QUANTITY&#x3D;최다수량, NEGOTIATION&#x3D;협상(임의), LIMITED_LOWEST&#x3D;제한적최저가, NEGOTIATION_AUTO&#x3D;협상(자동계산). | [optional] [default to undefined]
 **quoteCondition** | **string** | 견적서 제출 조건. UNIT_AUTO&#x3D;자동생성(단가), TOTAL_AUTO&#x3D;자동생성(총액), FILE&#x3D;직접첨부, NONE&#x3D;미제출. | [optional] [default to undefined]
 **preliminaryPriceRegion** | **string** | 예비가격 범위 (awardMethod&#x3D;LIMITED_LOWEST 필수). PLUS_MINUS_2&#x3D;±2%, PLUS_MINUS_3&#x3D;±3%, PLUS_MINUS_4&#x3D;±4%. | [optional] [default to undefined]

package/index.ts CHANGED Viewed

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 43.0.2
+ * The version of the OpenAPI document: 44.1.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/models/acceptance-result-response-dto.ts CHANGED Viewed

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 43.0.2
+ * The version of the OpenAPI document: 44.1.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/models/acknowledge-product-receipt200-response.ts CHANGED Viewed

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 43.0.2
+ * The version of the OpenAPI document: 44.1.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/models/acknowledge-products-request-dto.ts CHANGED Viewed

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
+ * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 봉투 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  봉투를 쓰지 않는 표면은 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 JSON이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2`의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified`를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`입니다. **HTTP status + `type` URI** 로 분기하세요. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도하고, `false`면 요청을 고쳐야 합니다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId`와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId`를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 적혀 있습니다.  ### 멱등성 위반: 409와 422의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**입니다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받습니다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈습니다. 재시도해도 영원히 같은 실패이니 새 키를 쓰거나 body를 되돌리세요.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분** 입니다. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나갑니다 — 신규 연동은 표준 필드를 쓰세요. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지합니다.  `429` 에서는 `Retry-After`(초)가 우선합니다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도하세요.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급합니다. 모든 응답(성공/에러)에 `X-Correlation-Id`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 43.0.2
+ * The version of the OpenAPI document: 44.1.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).