@cmarket/partner-sdk 38.2.0 → 38.4.0

package/docs/PartnerApiApi.md

@@ -228,7 +228,7 @@ const { status, data } = await apiInstance.completeFileUpload(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**200** | 업로드 확정 완료. 이제 `fileKey` 를 공고 등록·수정의 첨부 필드에 실을 수 있습니다. |  -  |
 |**400** | 입력 검증 실패(`type: …/validation-failed`), Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`), 또는 요청 내용이 유효하지 않음(`…/upstream-invalid-input`). |  -  |
 |**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
 |**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라이언트 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키의 대행 범위 밖(`…/buyer-scope-mismatch` — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(`…/upstream-forbidden`). |  -  |
@@ -355,7 +355,7 @@ const { status, data } = await apiInstance.createCardPayment(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**200** | 결제창 발행 완료. 반환된 주소로 결제자를 보내면 됩니다. |  -  |
 |**400** | 입력 검증 실패(`type: …/validation-failed`), Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`), 또는 요청 내용이 유효하지 않음(`…/upstream-invalid-input`). |  -  |
 |**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
 |**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라이언트 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키의 대행 범위 밖(`…/buyer-scope-mismatch` — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(`…/upstream-forbidden`). |  -  |
@@ -483,7 +483,7 @@ const { status, data } = await apiInstance.createFileUploadUrl(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** |  |  -  |
+|**201** | 업로드 주소 발급 완료. 이 주소로 파일 본문을 직접 PUT 한 뒤 반드시 확정(2/2)을 호출해야 `fileKey` 가 유효해집니다. |  -  |
 |**400** | 입력 검증 실패(`type: …/validation-failed`), Idempotency-Key 헤더 누락/형식 오류(`…/idempotency-key-required`, `…/idempotency-key-invalid`), 또는 요청 내용이 유효하지 않음(`…/upstream-invalid-input`). |  -  |
 |**401** | Bearer 토큰 없음(`type: …/missing-bearer-token`) 또는 만료/위변조/폐기(`…/invalid-token`). |  -  |
 |**403** | 키 미바인딩(`type: …/unbound-partner-key`), 클라이언트 IP 차단(`…/ip-not-allowed`), 스코프 부족(`…/insufficient-scope`), buyerId 가 키의 대행 범위 밖(`…/buyer-scope-mismatch` — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(`…/upstream-forbidden`). |  -  |
@@ -696,9 +696,11 @@ const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
 let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.getBid(
-    bidRef
+    bidRef,
+    ifNoneMatch
 );
 ```
 
@@ -707,6 +709,7 @@ const { status, data } = await apiInstance.getBid(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -726,7 +729,8 @@ const { status, data } = await apiInstance.getBid(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**200** | 공고 상세. 마감 전에는 참가자 신원이 가려져 나가고, 마감 이후 낙찰 여부는 &#x60;participants[].isWinner&#x60; 로 읽습니다. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -755,9 +759,11 @@ const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
 let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.getBidSettlement(
-    bidRef
+    bidRef,
+    ifNoneMatch
 );
 ```
 
@@ -766,6 +772,7 @@ const { status, data } = await apiInstance.getBidSettlement(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -785,7 +792,8 @@ const { status, data } = await apiInstance.getBidSettlement(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**200** | 낙찰 공급사의 사업자·계좌 정보와 공급가액/부가세, 응찰 품목내역. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -814,11 +822,13 @@ const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
 let bidRef: string; //발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. (default to undefined)
-let paperCode: number; // (optional) (default to undefined)
+let paperCode: number; //거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요. (optional) (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.getBidStatement(
     bidRef,
-    paperCode
+    paperCode,
+    ifNoneMatch
 );
 ```
 
@@ -827,7 +837,8 @@ const { status, data } = await apiInstance.getBidStatement(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **bidRef** | [**string**] | 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. | defaults to undefined|
-| **paperCode** | [**number**] |  | (optional) defaults to undefined|
+| **paperCode** | [**number**] | 거래명세서 서식 코드. 생략하면 해당 공고에 적용된 기본 서식으로 조회합니다. 기관에 서식이 여러 벌인 경우에만 지정하세요. | (optional) defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -847,7 +858,8 @@ const { status, data } = await apiInstance.getBidStatement(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**200** | 거래명세서 본문과 발행 메타. 정산 마감 전후 어느 시점에도 조회할 수 있습니다. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -876,9 +888,11 @@ const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
 let fileKey: string; //파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자). (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.getFileMeta(
-    fileKey
+    fileKey,
+    ifNoneMatch
 );
 ```
 
@@ -887,6 +901,7 @@ const { status, data } = await apiInstance.getFileMeta(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **fileKey** | [**string**] | 파일 키 — 업로드 응답의 fileKey(영문 대소문자·숫자 32자). | defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -906,7 +921,8 @@ const { status, data } = await apiInstance.getFileMeta(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**200** | 파일 메타(원본 파일명·크기·MIME). 내용은 포함하지 않습니다. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -965,7 +981,7 @@ const { status, data } = await apiInstance.getSemoContractTaxinvoiceStatus(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**200** | 세금계산서 발행 상태. 동결 표면이라 &#x60;{data}&#x60; 봉투를 씌우지 않습니다. |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
@@ -986,9 +1002,11 @@ const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
 let memberId: string; //계약업체 회원 ID (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.getSupplierCardPayableV2(
-    memberId
+    memberId,
+    ifNoneMatch
 );
 ```
 
@@ -997,6 +1015,7 @@ const { status, data } = await apiInstance.getSupplierCardPayableV2(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **memberId** | [**string**] | 계약업체 회원 ID | defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -1016,7 +1035,8 @@ const { status, data } = await apiInstance.getSupplierCardPayableV2(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**200** | 해당 공급사에 카드결제가 가능한지와, 불가하면 그 사유. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1045,9 +1065,11 @@ const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
 let endpointId: string; //구독 식별자(등록 응답의 `endpointId`). (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.getWebhookEndpoint(
-    endpointId
+    endpointId,
+    ifNoneMatch
 );
 ```
 
@@ -1056,6 +1078,7 @@ const { status, data } = await apiInstance.getWebhookEndpoint(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **endpointId** | [**string**] | 구독 식별자(등록 응답의 &#x60;endpointId&#x60;). | defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -1076,6 +1099,7 @@ const { status, data } = await apiInstance.getWebhookEndpoint(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 웹훅 구독 상세. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1103,11 +1127,18 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-const { status, data } = await apiInstance.healthControllerCheck();
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
+
+const { status, data } = await apiInstance.healthControllerCheck(
+    ifNoneMatch
+);
 ```
 
 ### Parameters
-This endpoint does not have any parameters.
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -1127,7 +1158,8 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**200** | 프로세스가 살아 있음. 의존성은 보지 않습니다(readiness 가 그 역할). |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**429** | rate limit 초과(&#x60;type: …/too-many-requests&#x60;) — 전역 60/min per client_id. 대기 시간은 &#x60;Retry-After&#x60;(초)가 우선하고, 잔여 쿼터·정책은 표준 필드 &#x60;RateLimit&#x60;/&#x60;RateLimit-Policy&#x60;(draft-ietf-httpapi-ratelimit-headers)로 나갑니다. 관용 헤더 &#x60;X-RateLimit-Limit&#x60;/&#x60;X-RateLimit-Remaining&#x60;/&#x60;X-RateLimit-Reset&#x60; 도 함께 실리지만 표준이 아니므로 새 연동은 표준 필드를 읽으세요. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책. 예: &#x60;\&quot;default\&quot;;q&#x3D;60;w&#x3D;60&#x60;. <br>  |
 |**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
 
@@ -1150,9 +1182,11 @@ const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
 let bidRefs: string; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 `bidRefs` 를 반복해 전달합니다. 최대 100건입니다. (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.listBidResults(
-    bidRefs
+    bidRefs,
+    ifNoneMatch
 );
 ```
 
@@ -1161,6 +1195,7 @@ const { status, data } = await apiInstance.listBidResults(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **bidRefs** | [**string**] | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidRefs&#x60; 를 반복해 전달합니다. 최대 100건입니다. | defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -1181,6 +1216,7 @@ const { status, data } = await apiInstance.listBidResults(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 요청한 공고의 응찰 결과 목록. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1213,13 +1249,15 @@ let cursor: string; //다음 페이지 커서(불투명 토큰). 직전 응답
 let bidRefs: Array<string>; //조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. (optional) (default to undefined)
 let status: Array<BidPublicStatus>; //공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다. (optional) (default to undefined)
 let include: Array<'results' | 'products' | 'contacts'>; //행별 확장 부착 CSV. `results`=응찰 참여자, `products`=공고 등록 품목, `contacts`=발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다). (optional) (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.listBids(
     limit,
     cursor,
     bidRefs,
     status,
-    include
+    include,
+    ifNoneMatch
 );
 ```
 
@@ -1232,6 +1270,7 @@ const { status, data } = await apiInstance.listBids(
 | **bidRefs** | **Array&lt;string&gt;** | 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. CSV 로 전달하며 최대 100건. 지정 시 그 공고만 조회합니다. | (optional) defaults to undefined|
 | **status** | **Array&lt;BidPublicStatus&gt;** | 공고 상태 필터(공개값) CSV. 지정 시 그중 하나라도 일치하는 공고만 조회합니다. | (optional) defaults to undefined|
 | **include** | **Array<&#39;results&#39; &#124; &#39;products&#39; &#124; &#39;contacts&#39;>** | 행별 확장 부착 CSV. &#x60;results&#x60;&#x3D;응찰 참여자, &#x60;products&#x60;&#x3D;공고 등록 품목, &#x60;contacts&#x60;&#x3D;발주 담당자 성명·연락처·이메일. 미지정이면 부착하지 않는다(응답이 가볍고 조회 비용도 들지 않는다). | (optional) defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -1252,6 +1291,7 @@ const { status, data } = await apiInstance.listBids(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 공고 요약 목록. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1345,12 +1385,14 @@ let endpointId: string; //이 구독의 전송만 조회합니다. 미지정이
 let status: PartnerWebhookDeliveryStatus; //전송 상태 필터. 미지정이면 전부. (optional) (default to undefined)
 let limit: number; //페이지 크기(1~200, 기본 50). (optional) (default to 50)
 let cursor: string; //다음 페이지 커서(불투명 토큰). 직전 응답의 `nextCursor` 를 그대로 전달합니다. 미지정 시 첫 페이지. (optional) (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.listWebhookDeliveries(
     endpointId,
     status,
     limit,
-    cursor
+    cursor,
+    ifNoneMatch
 );
 ```
 
@@ -1362,6 +1404,7 @@ const { status, data } = await apiInstance.listWebhookDeliveries(
 | **status** | **PartnerWebhookDeliveryStatus** | 전송 상태 필터. 미지정이면 전부. | (optional) defaults to undefined|
 | **limit** | [**number**] | 페이지 크기(1~200, 기본 50). | (optional) defaults to 50|
 | **cursor** | [**string**] | 다음 페이지 커서(불투명 토큰). 직전 응답의 &#x60;nextCursor&#x60; 를 그대로 전달합니다. 미지정 시 첫 페이지. | (optional) defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -1382,6 +1425,7 @@ const { status, data } = await apiInstance.listWebhookDeliveries(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 웹훅 전송 이력. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1409,11 +1453,18 @@ import {
 const configuration = new Configuration();
 const apiInstance = new PartnerApiApi(configuration);
 
-const { status, data } = await apiInstance.listWebhookEndpoints();
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
+
+const { status, data } = await apiInstance.listWebhookEndpoints(
+    ifNoneMatch
+);
 ```
 
 ### Parameters
-This endpoint does not have any parameters.
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -1434,6 +1485,7 @@ This endpoint does not have any parameters.
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 웹훅 구독 목록. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1630,7 +1682,7 @@ const { status, data } = await apiInstance.registerBid(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** |  |  -  |
+|**201** | 공고 등록 완료. 발급된 &#x60;bidId&#x60;(c-market 공고번호)와 보낸 &#x60;purchaseNo&#x60; 를 함께 돌려주므로 이후 조회에 어느 쪽을 써도 됩니다. |  -  |
 |**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 요청 내용이 유효하지 않음(&#x60;…/upstream-invalid-input&#x60;). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -1694,7 +1746,7 @@ const { status, data } = await apiInstance.registerSemoContract(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** |  |  -  |
+|**200** | 외부 계약 등록 완료. 동결 표면이라 &#x60;{data}&#x60; 봉투를 씌우지 않습니다. |  -  |
 |**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 요청 내용이 유효하지 않음(&#x60;…/upstream-invalid-input&#x60;). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |
@@ -2229,7 +2281,7 @@ const { status, data } = await apiInstance.uploadFile(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**201** |  |  -  |
+|**201** | 업로드 완료. 받은 &#x60;fileKey&#x60; 를 공고 등록·수정의 첨부 필드에 실으세요. 같은 파일을 여러 공고에 재사용할 수 있습니다. |  -  |
 |**400** | 입력 검증 실패(&#x60;type: …/validation-failed&#x60;), Idempotency-Key 헤더 누락/형식 오류(&#x60;…/idempotency-key-required&#x60;, &#x60;…/idempotency-key-invalid&#x60;), 또는 요청 내용이 유효하지 않음(&#x60;…/upstream-invalid-input&#x60;). |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |

package/docs/ProductsApi.md

@@ -88,9 +88,11 @@ const configuration = new Configuration();
 const apiInstance = new ProductsApi(configuration);
 
 let limit: number; //한 번에 받을 최대 물품 수(1~1000). 미지정이면 미전송 물품을 **전부** 받습니다(종전 동작). 카탈로그가 커서 응답이 부담스러우면 이 값을 주고 `meta.hasMore` 가 `false` 가 될 때까지 반복하세요. (optional) (default to undefined)
+let ifNoneMatch: string; //직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. (optional) (default to undefined)
 
 const { status, data } = await apiInstance.listProducts(
-    limit
+    limit,
+    ifNoneMatch
 );
 ```
 
@@ -99,6 +101,7 @@ const { status, data } = await apiInstance.listProducts(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **limit** | [**number**] | 한 번에 받을 최대 물품 수(1~1000). 미지정이면 미전송 물품을 **전부** 받습니다(종전 동작). 카탈로그가 커서 응답이 부담스러우면 이 값을 주고 `meta.hasMore` 가 `false` 가 될 때까지 반복하세요. | (optional) defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 `ETag` 값. 내용이 그대로면 본문 없이 `304` 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -119,6 +122,7 @@ const { status, data } = await apiInstance.listProducts(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | 미전송 물품 목록. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
 |**400** | 쿼리/본문 입력 검증 실패(&#x60;type: …/validation-failed&#x60;) — 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#x60; 등. |  -  |
 |**401** | Bearer 토큰 없음(&#x60;type: …/missing-bearer-token&#x60;) 또는 만료/위변조/폐기(&#x60;…/invalid-token&#x60;). |  -  |
 |**403** | 키 미바인딩(&#x60;type: …/unbound-partner-key&#x60;), 클라이언트 IP 차단(&#x60;…/ip-not-allowed&#x60;), 스코프 부족(&#x60;…/insufficient-scope&#x60;), buyerId 가 키의 대행 범위 밖(&#x60;…/buyer-scope-mismatch&#x60; — 샌드박스 키의 범위 위반도 이 slug), 또는 요청 권한 없음(&#x60;…/upstream-forbidden&#x60;). |  -  |

package/docs/WebhookBidEventData.md

@@ -0,0 +1,27 @@
+# WebhookBidEventData
+
+공고 상태 전이 이벤트의 본문. 상세는 `GET /v2/bids/{bidId}` 가 SSOT 입니다.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bidId** | **string** | 공고 식별자. | [default to undefined]
+**status** | [**BidPublicStatus**](BidPublicStatus.md) | 전이 후 공고 상태(공개값). | [default to undefined]
+**previousStatus** | [**BidPublicStatus**](BidPublicStatus.md) | 전이 전 공고 상태(공개값). 직전 상태를 특정할 수 없으면 null. | [optional] [default to undefined]
+**occurredAt** | **string** | 전이 시각(UTC ISO-8601). | [default to undefined]
+
+## Example
+
+```typescript
+import { WebhookBidEventData } from '@cmarket/partner-sdk';
+
+const instance: WebhookBidEventData = {
+    bidId,
+    status,
+    previousStatus,
+    occurredAt,
+};
+```
+
+[[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/WebhookEventEnvelope.md

@@ -0,0 +1,27 @@
+# WebhookEventEnvelope
+
+모든 웹훅 본문의 공통 봉투. 필드 순서가 곧 서명 대상 바이트 순서입니다.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | 이벤트 식별자. `webhook-id` 헤더와 같은 값입니다. | [default to undefined]
+**type** | **string** | 이벤트 타입. | [default to undefined]
+**createdAt** | **string** | 이벤트 발생 시각(UTC ISO-8601). | [default to undefined]
+**data** | **{ [key: string]: any; }** | 이벤트별 본문. 아래 이벤트 항목의 스키마를 보세요. | [default to undefined]
+
+## Example
+
+```typescript
+import { WebhookEventEnvelope } from '@cmarket/partner-sdk';
+
+const instance: WebhookEventEnvelope = {
+    id,
+    type,
+    createdAt,
+    data,
+};
+```
+
+[[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/WebhookPingEventData.md

@@ -0,0 +1,21 @@
+# WebhookPingEventData
+
+연결 확인 발송의 본문.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**endpointId** | **string** | 확인을 요청한 구독 식별자. | [default to undefined]
+
+## Example
+
+```typescript
+import { WebhookPingEventData } from '@cmarket/partner-sdk';
+
+const instance: WebhookPingEventData = {
+    endpointId,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)