@cmarket/partner-sdk 39.0.0 → 40.0.0

package/docs/PartnerWebhookEndpointStatus.md

@@ -1,6 +1,6 @@
 # PartnerWebhookEndpointStatus
 
-구독 상태. `DISABLED` 면 발송이 멈춘 상태이며 `PATCH … {\"status\":\"ACTIVE\"}` 로 되살립니다.
+구독 상태. `DISABLED` 면 발송이 멈춘 상태이며 `PATCH … {\"status\":\"ACTIVE\"}`로 되살립니다.
 
 ## Enum
 

package/docs/ProblemDetailsDto.md

@@ -12,7 +12,7 @@ Name | Type | Description | Notes
 **instance** | **string** | 요청 경로(에러 발생 URI). | [optional] [default to undefined]
 **retryable** | **boolean** | 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도 가능, `false`(그 외 4xx)면 요청을 고쳐야 합니다. `Retry-After` 헤더가 있으면 그 대기값을 존중하세요. | [default to undefined]
 **traceId** | **string** | 요청 추적 id — `X-Correlation-Id` 응답 헤더와 같은 값입니다. 문의할 때 이 값을 첨부하세요. | [optional] [default to undefined]
-**correlationId** | **string** | `traceId` 와 같은 값의 옛 이름입니다. 기존 연동 호환으로 함께 실립니다 — 새 연동은 `traceId` 를 읽으세요. | [optional] [default to undefined]
+**correlationId** | **string** | `traceId`와 같은 값의 옛 이름입니다. 기존 연동 호환으로 함께 실립니다 — 새 연동은 `traceId`를 읽으세요. | [optional] [default to undefined]
 **invalid_params** | [**Array<InvalidParamDto>**](InvalidParamDto.md) | RFC 9457 확장 — 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(값 없음). 그 외 에러엔 부재. | [optional] [default to undefined]
 
 ## Example

package/docs/ProductResponseDto.md

@@ -7,7 +7,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **productCode** | **number** | 물품 코드. 수신확인(`POST /v2/products/receipts`)에 이 값을 되돌려주세요. | [default to undefined]
 **productName** | **string** | 물품명. | [default to undefined]
-**itemCode** | **string** | 품목코드 — 발주기관 ERP 의 품번과 대조하는 축입니다. | [default to undefined]
+**itemCode** | **string** | 품목코드 — 발주기관 ERP의 품번과 대조하는 축입니다. | [default to undefined]
 **spec** | **string** | 규격. | [default to undefined]
 **unit** | **string** | 단위. | [default to undefined]
 **capacity** | **string** | 용량. | [default to undefined]

package/docs/ProductsApi.md

@@ -10,7 +10,7 @@ All URIs are relative to *https://partner-api.c-market.net*
 # **acknowledgeProductReceipt**
 > AcknowledgeProductReceipt200Response acknowledgeProductReceipt(acknowledgeProductsRequestDto)
 
-저장을 마친 물품을 전송완료로 표시해 다음 조회에서 제외합니다.  **되돌릴 수 없습니다.** 표시한 물품은 `GET /v2/products` 로 다시 내려오지 않으므로, 자기 시스템에 저장이 끝난 뒤에 호출하세요.  **표시 범위는 기관 그룹으로 잠깁니다.** 다른 기관의 물품 코드를 섞어 보내면 그 건은 표시되지 않고 `acknowledged` 가 요청 수보다 작게 돌아옵니다.  **필수 스코프:** `products:write`  **멱등성:** `Idempotency-Key` 헤더 필수.
+저장을 마친 물품을 전송완료로 표시해 다음 조회에서 제외합니다. 스코프 `products:write` · `Idempotency-Key` 헤더 필수.  - 되돌릴 수 없습니다. 자기 시스템에 저장이 끝난 뒤 호출하세요. - 다른 기관의 물품 코드는 표시되지 않고 `acknowledged`가 요청 수보다 작게 돌아옵니다.
 
 ### Example
 
@@ -24,7 +24,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new ProductsApi(configuration);
 
-let idempotencyKey: string; //멱등성 키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: `bid-create-{구매번호}`)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
+let idempotencyKey: string; //멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. (default to undefined)
 let acknowledgeProductsRequestDto: AcknowledgeProductsRequestDto; //
 
 const { status, data } = await apiInstance.acknowledgeProductReceipt(
@@ -38,7 +38,7 @@ const { status, data } = await apiInstance.acknowledgeProductReceipt(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **acknowledgeProductsRequestDto** | **AcknowledgeProductsRequestDto**|  | |
-| **idempotencyKey** | [**string**] | 멱등성 키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때 처음과 같은 키를 다시 보내야** 중복 생성이 막힙니다 — 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청으로 처리됩니다. 그래서 키는 UUID v4 를 만들어 **연동 시스템 원장에 저장**하거나, 요청 내용에서 결정적으로 파생(예: `bid-create-{구매번호}`)해 재시도가 같은 값을 재현하도록 하세요. 같은 키 + 같은 body 는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
+| **idempotencyKey** | [**string**] | 멱등키(1~255자, `[A-Za-z0-9_-]`). **재시도할 때는 처음과 같은 키를 보내야** 중복 생성이 막힙니다. 타임아웃·네트워크 오류로 다시 부르면서 새 키를 만들면 별개 요청이 됩니다. UUID v4를 만들어 연동 시스템에 저장하거나, 요청 내용에서 결정적으로 파생하세요(예: `bid-create-{구매번호}`). 같은 키와 같은 body는 24시간 동안 캐시된 응답을 그대로 돌려줍니다. | defaults to undefined|
 
 
 ### Return type
@@ -58,23 +58,23 @@ const { status, data } = await apiInstance.acknowledgeProductReceipt(
 ### HTTP response details
 | 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;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;). |  -  |
-|**409** | 원 요청이 아직 처리 중인 상태에서 같은 Idempotency-Key 재전송(&#x60;type: …/idempotency-key-conflict&#x60; — 잠시 뒤 같은 키로 재시도하면 결과를 받는다) 또는 현재 상태와 충돌하는 요청(&#x60;…/upstream-conflict&#x60;). |  -  |
-|**422** | 동일 Idempotency-Key 를 **다른 body** 로 재전송(&#x60;type: …/idempotency-key-reused&#x60;). 재시도해도 동일 실패 — 새 키를 쓰거나 body 를 원래대로 되돌려야 한다. 형식은 맞지만 내용상 처리할 수 없는 요청(&#x60;…/upstream-unprocessable&#x60;)도 이 상태다. |  -  |
-|**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;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청을 처리하지 못했습니다(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적으로 처리할 수 없습니다(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
+|**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;). |  -  |
+|**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;). 앞의 경우 잠시 후 같은 키로 재시도하면 결과를 받습니다. |  -  |
+|**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;. |  -  |
+|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
+|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
 
 [[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)
 
 # **listProducts**
 > ListProducts200Response listProducts()
 
-기관에 공유된 물품 중 **아직 전송되지 않은 것**을 조회합니다.  **증분 피드입니다.** 가져간 물품을 `POST /v2/products/receipts` 로 수신확인하면 다음 조회 결과에서 빠집니다. 수신확인을 하지 않으면 같은 물품이 계속 내려옵니다.  **권장 흐름:** 조회 → 자기 시스템에 저장 → 저장에 성공한 물품 코드만 수신확인. 저장 전에 수신확인하면 그 물품은 다시 받을 수 없습니다.  **나눠 받기:** `limit` 을 주면 그만큼만 받고, 남은 것이 있으면 `meta.hasMore` 가 `true` 입니다. 커서는 없습니다 — 다음 묶음은 \"커서 다음\" 이 아니라 **아직 수신확인하지 않은 것**이라, 위 흐름을 `meta.hasMore` 가 `false` 가 될 때까지 반복하면 됩니다. `limit` 을 빼면 전부 한 번에 받습니다.  **조회 범위:** 요청 키가 대행하는 기관 그룹입니다. 기관 그룹이 설정되지 않은 키는 403 입니다.  **필수 스코프:** `products:read`
+기관에 공유된 물품 중 아직 전송되지 않은 것을 조회합니다. 스코프 `products:read`.  - 증분 피드입니다. `POST /v2/products/receipts`로 수신확인한 물품은 다음 조회에서 빠지고, 하지 않으면 계속 내려옵니다. - 순서는 조회 → 자기 시스템에 저장 → 저장에 성공한 물품만 수신확인입니다. - `limit`을 주면 그만큼 받고 남은 것이 있으면 `meta.hasMore`가 `true`입니다. 커서가 없으므로 `false`가 될 때까지 위 순서를 반복합니다. `limit`을 빼면 전부 한 번에 받습니다. - 기관 그룹이 설정되지 않은 키는 403입니다.
 
 ### Example
 
@@ -87,8 +87,8 @@ import {
 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)
+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,
@@ -100,8 +100,8 @@ const { status, data } = await apiInstance.listProducts(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **limit** | [**number**] | 한 번에 받을 최대 물품 수(1~1000). 미지정이면 미전송 물품을 **전부** 받습니다(종전 동작). 카탈로그가 커서 응답이 부담스러우면 이 값을 주고 &#x60;meta.hasMore&#x60; 가 &#x60;false&#x60; 가 될 때까지 반복하세요. | (optional) defaults to undefined|
-| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60; 로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
+| **limit** | [**number**] | 한 번에 받을 최대 물품 수(1~1000). 미지정이면 미전송 물품을 **전부** 받습니다(종전 동작). 카탈로그가 커서 응답이 부담스러우면 이 값을 주고 &#x60;meta.hasMore&#x60;가 &#x60;false&#x60;가 될 때까지 반복하세요. | (optional) defaults to undefined|
+| **ifNoneMatch** | [**string**] | 직전 응답의 &#x60;ETag&#x60; 값. 내용이 그대로면 본문 없이 &#x60;304&#x60;로 끝납니다 — 폴링에서 전송량과 파싱 비용이 사라집니다. | (optional) defaults to undefined|
 
 
 ### Return type
@@ -121,16 +121,16 @@ const { status, data } = await apiInstance.listProducts(
 ### HTTP response details
 | 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>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60; 를 본문 없이 받습니다. <br>  |
-|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0 에 가까워지면 요청 간격을 늘리세요 — 429 를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * 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;). |  -  |
-|**404** | 대상을 찾을 수 없습니다(&#x60;type: …/upstream-not-found&#x60;). |  -  |
-|**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;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  |
-|**500** | 서버 내부 오류(&#x60;type: …/internal-server-error&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**502** | 요청을 처리하지 못했습니다(&#x60;type: …/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
-|**503** | 일시적으로 처리할 수 없습니다(&#x60;type: …/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더 참조. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
+|**200** | 미전송 물품 목록. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
+|**304** | &#x60;If-None-Match&#x60; 지문이 현재 리소스와 같습니다 — 내용이 바뀌지 않았습니다. **본문이 없습니다.** 직전에 받은 값을 그대로 쓰세요. |  * RateLimit - 현재 창의 잔여 쿼터(&#x60;r&#x60;)와 리셋까지 남은 초(&#x60;t&#x60;). 이 값이 0에 가까워지면 요청 간격을 늘리세요 — 429를 만나기 전에 조절하라고 주는 값입니다. <br>  * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br>  * ETag - 리소스 지문(weak). 다음 요청의 &#x60;If-None-Match&#x60; 헤더로 되보내면 내용이 그대로일 때 &#x60;304 Not Modified&#x60;를 본문 없이 받습니다. <br>  |
+|**400** | 입력 검증 실패(&#x60;…/validation-failed&#x60;). 상한 초과(&#x60;bidRefs&#x60; 101건 등), 값 형식 위반, 알 수 없는 &#x60;cursor&#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;). |  -  |
+|**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). |  -  |
+|**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;. |  -  |
+|**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. |  -  |
+|**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. |  * Retry-After - 재시도까지 대기할 초. <br>  |
 
 [[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)
 

package/docs/ProtectedResourceMetadataDto.md

@@ -5,12 +5,12 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**resource** | **string** | 이 보호 자원의 식별자(=이 API 의 origin). RFC 9728 §2 필수. | [default to undefined]
-**authorization_servers** | **Array<string>** | 이 자원의 토큰을 발급할 수 있는 authorization server 의 issuer 목록. 클라이언트는 401 을 받으면 여기서 토큰을 받는다. | [default to undefined]
+**resource** | **string** | 이 보호 자원의 식별자(=이 API의 origin). RFC 9728 §2 필수. | [default to undefined]
+**authorization_servers** | **Array<string>** | 이 자원의 토큰을 발급할 수 있는 authorization server의 issuer 목록. 클라이언트는 401을 받으면 여기서 토큰을 받는다. | [default to undefined]
 **scopes_supported** | **Array<string>** | 이 자원이 이해하는 scope 전체. | [default to undefined]
-**bearer_methods_supported** | **Array<string>** | access token 전달 방식 (RFC 6750). `header` 만 받는다 — 쿼리스트링·본문 전달은 접근 로그·리퍼러로 토큰이 새는 경로다. | [default to undefined]
+**bearer_methods_supported** | **Array<string>** | access token 전달 방식 (RFC 6750). `header`만 받는다 — 쿼리스트링·본문 전달은 접근 로그·리퍼러로 토큰이 새는 경로다. | [default to undefined]
 **dpop_signing_alg_values_supported** | **Array<string>** | DPoP proof 서명에 받아 주는 알고리즘 (RFC 9449 §5.1). | [default to undefined]
-**dpop_bound_access_tokens_required** | **boolean** | DPoP 바인딩 토큰을 **전역으로** 강제하는지. false — DPoP 는 키 단위 설정이라 파트너마다 다르다. true 로 광고하면 DPoP 를 쓰지 않는 정상 키의 클라이언트가 스스로 실패한다. | [default to undefined]
+**dpop_bound_access_tokens_required** | **boolean** | DPoP 바인딩 토큰을 **전역으로** 강제하는지. false — DPoP는 키 단위 설정이라 파트너마다 다르다. true로 광고하면 DPoP를 쓰지 않는 정상 키의 클라이언트가 스스로 실패한다. | [default to undefined]
 **resource_documentation** | **string** | 사람이 읽는 API 문서 위치. | [default to undefined]
 
 ## Example

package/docs/RegisterAwardRequestDto.md

@@ -5,9 +5,9 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**winnerMemberId** | **string** | 낙찰자(공급사) 회원 ID. winnerSequence 가 없으면 필수(낙찰자 식별). winnerSequence 가 있으면 생략 가능. | [optional] [default to undefined]
-**winnerSequence** | **number** | 낙찰자 응찰 순번(낙찰 결과 조회의 sequence). 복수 응찰 시 정확한 응찰 건을 지정합니다. 없으면 winnerMemberId 로 첫 응찰 건을 해소합니다. | [optional] [default to undefined]
-**deliveryDateOverride** | **string** | 납품희망일 override(YYYY-MM-DD). 지정하면 공고의 납품일자를 이 값으로 덮어쓴다. 없으면 공고 등록 시 지정한 납품일자를 유지합니다. | [optional] [default to undefined]
+**winnerMemberId** | **string** | 낙찰자(공급사) 회원 ID. winnerSequence가 없으면 필수(낙찰자 식별). winnerSequence가 있으면 생략 가능. | [optional] [default to undefined]
+**winnerSequence** | **number** | 낙찰자 응찰 순번(낙찰 결과 조회의 sequence). 복수 응찰 시 정확한 응찰 건을 지정합니다. 없으면 winnerMemberId로 첫 응찰 건을 해소합니다. | [optional] [default to undefined]
+**deliveryDateOverride** | **string** | 납품희망일 덮어쓰기(YYYY-MM-DD). 지정하면 공고의 납품일자가 이 값이 됩니다. 없으면 공고 등록 시 지정한 납품일자를 유지합니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/RegisterSemoContractRequestDto.md

@@ -9,13 +9,13 @@ Name | Type | Description | Notes
 **buyerMemberId** | **string** | 발주기관 회원 ID (씨마켓 `member_id`). **계산서 공급받는자**가 됩니다. | [default to undefined]
 **supplierMemberId** | **string** | 공급기업 회원 ID (씨마켓 `member_id`). **계산서 공급자(발행 주체)**가 됩니다. | [default to undefined]
 **projectName** | **string** | 거래명 — 계산서 품목명과 목록 표시에 쓰입니다. | [default to undefined]
-**supplyPrice** | **number** | 과세 공급가액 — **부가세를 뺀 금액**입니다(결제창 API 와 달리 포함가가 아닙니다). | [default to undefined]
+**supplyPrice** | **number** | 과세 공급가액 — **부가세를 뺀 금액**입니다(결제창 API와 달리 포함가가 아닙니다). | [default to undefined]
 **vatAmount** | **number** | 부가세. | [default to undefined]
-**taxFreeAmount** | **number** | 면세 공급가액. 과세만 있으면 0 을 보냅니다. | [default to undefined]
+**taxFreeAmount** | **number** | 면세 공급가액. 과세만 있으면 0을 보냅니다. | [default to undefined]
 **externalContractNumber** | **string** | 파트너 측 계약번호 — 목록·계산서 조회의 실마리로 쓰입니다. | [optional] [default to undefined]
 **externalQuoteRequestId** | **string** | 파트너 측 견적요청 식별자. | [optional] [default to undefined]
 **requestNumber** | **string** | 파트너 측 접수번호. | [optional] [default to undefined]
-**paymentChannel** | **string** | 계약 시점에 발주기관이 고른 대금 지급 수단. `cash` 는 계산서 발행요청 경로, `card` 는 결제창 경로입니다. 모르면 보내지 않습니다. | [optional] [default to undefined]
+**paymentChannel** | **string** | 계약 시점에 발주기관이 고른 대금 지급 수단. `cash`는 계산서 발행요청 경로, `card`는 결제창 경로입니다. 모르면 보내지 않습니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/RequestInvoiceSplitRequestDto.md

@@ -6,8 +6,8 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **supplyAmount** | **number** | 분할 발급할 공급가액(원). | [default to undefined]
-**vat** | **number** | 분할 발급할 부가세(원). 면세면 0 입니다. | [default to undefined]
-**issueDate** | **string** | 발급 희망일(`YYYY-MM-DD`). 미지정 시 서버 기본값을 씁니다. **미래 일자는 400 으로 거절되며, \"오늘\" 은 한국 표준시(KST, UTC+9) 달력일입니다** — UTC 로 환산하지 말고 발주기관 달력의 날짜를 그대로 보내세요. | [optional] [default to undefined]
+**vat** | **number** | 분할 발급할 부가세(원). 면세면 0입니다. | [default to undefined]
+**issueDate** | **string** | 발급 희망일(`YYYY-MM-DD`). 미지정 시 서버 기본값을 씁니다. **미래 일자는 400으로 거절되며, \"오늘\" 은 한국 표준시(KST, UTC+9) 달력일입니다** — UTC로 환산하지 말고 발주기관 달력의 날짜를 그대로 보내세요. | [optional] [default to undefined]
 
 ## Example
 

package/docs/RevokeRequestDto.md

@@ -5,12 +5,12 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**token** | **string** | 폐기할 토큰. 이 API 는 access token 만 발급하므로 access token 을 넣습니다. | [default to undefined]
-**token_type_hint** | **string** | 토큰 종류 힌트. 이 API 는 access_token 만 발급하므로 무시됩니다. | [optional] [default to undefined]
+**token** | **string** | 폐기할 토큰. 이 API는 access token만 발급하므로 access token을 넣습니다. | [default to undefined]
+**token_type_hint** | **string** | 토큰 종류 힌트. 이 API는 access_token만 발급하므로 무시됩니다. | [optional] [default to undefined]
 **client_id** | **string** | client_id (Basic 인증 헤더를 쓰지 않는 경우) | [optional] [default to undefined]
 **client_secret** | **string** | client_secret (Basic 인증 헤더를 쓰지 않는 경우) | [optional] [default to undefined]
 **client_assertion** | **string** | RFC 7523 private_key_jwt 인증용 서명 JWT (공개키가 등록된 키). | [optional] [default to undefined]
-**client_assertion_type** | **string** | client_assertion 의 종류. RFC 7523 이 정한 고정 URN 만 허용합니다. | [optional] [default to undefined]
+**client_assertion_type** | **string** | client_assertion의 종류. RFC 7523이 정한 고정 URN만 허용합니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/SemoContractRegisteredResponseDto.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**taxInvoiceTargetId** | **string** | 씨마켓 발행 대상 식별자. **이후 계산서 관련 조회에 이 값을 씁니다** — 파트너 측 계약 id 가 아닙니다. | [default to undefined]
+**taxInvoiceTargetId** | **string** | 씨마켓 발행 대상 식별자. **이후 계산서 관련 조회에 이 값을 씁니다** — 파트너 측 계약 id가 아닙니다. | [default to undefined]
 **status** | **string** | 등록 상태. | [default to undefined]
 **reused** | **boolean** | 이미 등록돼 있어 기존 대상을 그대로 돌려준 경우 `true`(멱등 재요청). | [default to undefined]
 

package/docs/StatementDocumentDto.md

@@ -8,7 +8,7 @@ Name | Type | Description | Notes
 **sequence** | **number** | 파일 순번 — documents 배열 내 1-indexed 위치(결정적 순서). | [default to undefined]
 **paperCode** | **number** | 문서 종류 코드 (paperCode). | [default to undefined]
 **fileName** | **string** | 파일명. 미발급 시 null. | [default to undefined]
-**fileUrl** | **string** | 파일 다운로드 URL — 만료 없는 안정 URL. GET 하면 실제 파일로 302 된다. 미발급 시 null. | [default to undefined]
+**fileUrl** | **string** | 파일 다운로드 주소(만료 없음). `GET` 하면 실제 파일로 302 됩니다. 미발급이면 `null`. | [default to undefined]
 
 ## Example
 

package/docs/TokenRequestDto.md

@@ -5,12 +5,12 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**grant_type** | **string** | OAuth 2.0 grant type. 현재 client_credentials 만 지원. | [default to undefined]
+**grant_type** | **string** | OAuth 2.0 grant type. 현재 client_credentials만 지원. | [default to undefined]
 **client_id** | **string** | 파트너 client_id (client_secret_post 방식). Basic 인증 시 생략. | [optional] [default to undefined]
 **client_secret** | **string** | 파트너 client_secret (client_secret_post 방식). Basic 인증 시 생략. | [optional] [default to undefined]
-**scope** | **string** | space-separated 요청 스코프. 미지정 시 client 의 전체 스코프 발급. | [optional] [default to undefined]
+**scope** | **string** | space-separated 요청 스코프. 미지정 시 client의 전체 스코프 발급. | [optional] [default to undefined]
 **client_assertion** | **string** | RFC 7523 private_key_jwt 인증용 서명 JWT. 공개키가 등록된 키는 client_secret 대신 이 값을 보냅니다. | [optional] [default to undefined]
-**client_assertion_type** | **string** | client_assertion 의 종류. RFC 7523 이 정한 고정 URN 만 허용합니다. | [optional] [default to undefined]
+**client_assertion_type** | **string** | client_assertion의 종류. RFC 7523이 정한 고정 URN만 허용합니다. | [optional] [default to undefined]
 
 ## Example
 

package/docs/TokenResponseDto.md

@@ -6,7 +6,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **access_token** | **string** | 발급된 JWT access token. | [default to undefined]
-**token_type** | **string** | Authorization 헤더에 쓸 스킴입니다. DPoP 로 발급된 토큰은 `DPoP`, 그 외는 `Bearer` 입니다. | [default to undefined]
+**token_type** | **string** | Authorization 헤더에 쓸 스킴입니다. DPoP로 발급된 토큰은 `DPoP`, 그 외는 `Bearer`입니다. | [default to undefined]
 **expires_in** | **number** | 유효 기간 (초). | [default to undefined]
 **scope** | **string** | 발급된 스코프 (space-separated). | [default to undefined]
 

package/docs/UpdateBidRequestDto.md

@@ -9,9 +9,9 @@ Name | Type | Description | Notes
 **projectName** | **string** | 공고명. | [optional] [default to undefined]
 **noticeContent** | **string** | 공고 상세 내용. (길이 제한 없음) | [optional] [default to undefined]
 **disclosePlannedAmount** | **boolean** | 예정금액(예산) 공개 여부. | [optional] [default to undefined]
-**attachments** | [**Array<BidAttachmentInputDto>**](BidAttachmentInputDto.md) | 공고 첨부파일 목록. 원소마다 `fileKey`(이미 올린 파일) · `url` · `base64` 중 **하나**를 담습니다. `url`·`base64` 를 쓰면 별도 업로드 호출 없이 이 요청 하나로 끝납니다. 큰 파일이나 여러 공고에 재사용할 파일은 `POST /v2/files/upload-url` 로 먼저 올리고 `fileKey` 로 참조하세요. | [optional] [default to undefined]
+**attachments** | [**Array<BidAttachmentInputDto>**](BidAttachmentInputDto.md) | 공고 첨부파일 목록. 원소마다 `fileKey`(이미 올린 파일) · `url` · `base64` 중 **하나**를 담습니다. `url`·`base64`를 쓰면 별도 업로드 호출 없이 이 요청 하나로 끝납니다. 큰 파일이나 여러 공고에 재사용할 파일은 `POST /v2/files/upload-url`로 먼저 올리고 `fileKey`로 참조하세요. | [optional] [default to undefined]
 **items** | [**Array<BidItemDto>**](BidItemDto.md) | 품목 목록(1개 이상). | [optional] [default to undefined]
-**totalBudget** | **number** | 총 예산금액(원). items 합계 대신 별도 totalBudget 으로 override 할 때 사용. | [optional] [default to undefined]
+**totalBudget** | **number** | 총 예산금액(원). items 합계 대신 별도 totalBudget으로 override 할 때 사용. | [optional] [default to undefined]
 **awardMethod** | **string** | 낙찰 방법(필수). LOWEST_PRICE=최저가, APPROPRIATE_PRICE=적정가, HIGHEST_PRICE=최고가, MAX_QUANTITY=최다수량, NEGOTIATION=협상(임의), LIMITED_LOWEST=제한적최저가, NEGOTIATION_AUTO=협상(자동계산). | [optional] [default to undefined]
 **quoteCondition** | **string** | 견적서 제출 조건. UNIT_AUTO=자동생성(단가), TOTAL_AUTO=자동생성(총액), FILE=직접첨부, NONE=미제출. | [optional] [default to undefined]
 **preliminaryPriceRegion** | **string** | 예비가격 범위 (awardMethod=LIMITED_LOWEST 필수). PLUS_MINUS_2=±2%, PLUS_MINUS_3=±3%, PLUS_MINUS_4=±4%. | [optional] [default to undefined]
@@ -39,7 +39,7 @@ Name | Type | Description | Notes
 **isAnnualContract** | **boolean** | 연간계약 여부. true=연간계약, false=일반. | [optional] [default to undefined]
 **isNominatedContract** | **boolean** | 지명계약 여부. true=지명계약(등록 시 초안 상태로 저장되어 별도 게시가 필요), false=일반. 지명업체 목록은 미지원(true/false 플래그만). | [optional] [default to undefined]
 **buyerManagerId** | **string** | 발주기관 담당자 식별자. | [optional] [default to undefined]
-**purchaseNo** | **string** | 발주처 지정 조달번호 (외부 ERP 자체 PO 번호). 동일 PO 의 선행 입찰이 전부 취소/유찰이면 재입찰로 새 번호가 채번되고, 진행 중이면 중복으로 거부됩니다. | [optional] [default to undefined]
+**purchaseNo** | **string** | 발주기관 지정 조달번호(외부 ERP의 구매번호). 동일 PO의 선행 입찰이 전부 취소/유찰이면 재입찰로 새 번호가 채번되고, 진행 중이면 중복으로 거부됩니다. | [optional] [default to undefined]
 **isResultPublished** | **boolean** | 결과 공개 여부. true=공개, false=비공개. | [optional] [default to undefined]
 **contractManager** | [**BidManagerDto**](BidManagerDto.md) | 계약 담당자. | [optional] [default to undefined]
 **techManager** | [**BidManagerDto**](BidManagerDto.md) | 기술 담당자. | [optional] [default to undefined]

package/docs/UpdateWebhookEndpointRequestDto.md

@@ -7,7 +7,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **url** | **string** | 새 수신 주소(HTTPS). | [optional] [default to undefined]
 **eventTypes** | [**Set<PartnerWebhookEventType>**](PartnerWebhookEventType.md) | 구독 이벤트 타입 **전체 치환**. 최소 1개, 중복 불가. | [optional] [default to undefined]
-**status** | [**PartnerWebhookEndpointStatus**](PartnerWebhookEndpointStatus.md) | 구독 상태. 연속 실패로 자동 중지(`DISABLED`)된 구독을 고친 뒤 `ACTIVE` 로 되살릴 때 씁니다. 잠시 발송을 멈추려면 `DISABLED` 로 보내세요. | [optional] [default to undefined]
+**status** | [**PartnerWebhookEndpointStatus**](PartnerWebhookEndpointStatus.md) | 구독 상태. 연속 실패로 자동 중지(`DISABLED`)된 구독을 고친 뒤 `ACTIVE`로 되살릴 때 씁니다. 잠시 발송을 멈추려면 `DISABLED`로 보내세요. | [optional] [default to undefined]
 
 ## Example
 

package/docs/UploadFileRequestDto.md

@@ -6,8 +6,8 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **fileName** | **string** | 파일명입니다(확장자 포함, 최대 255자). 허용 형식: PDF, HWP, HWPX, HWT, DOC, DOCX, XLS, XLSX, CELL, PPT, PPTX, SHOW, TXT, CSV, ZIP, JPG, JPEG, PNG, GIF, BMP, TIFF, TIF, DWG, DXF, STEP, STP, IGES, IGS, STL (accept: `.pdf,.hwp,.hwpx,.hwt,.doc,.docx,.xls,.xlsx,.cell,.ppt,.pptx,.show,.txt,.csv,.zip,.jpg,.jpeg,.png,.gif,.bmp,.tiff,.tif,.dwg,.dxf,.step,.stp,.iges,.igs,.stl`). 그 외 확장자는 거부됩니다. | [default to undefined]
-**base64** | **string** | Base64 인코딩된 파일 데이터. url 이 없을 때 필수. 디코딩 후 최대 23MB. | [optional] [default to undefined]
-**url** | **string** | 다운로드 가능한 파일 URL. base64 가 없을 때 필수. | [optional] [default to undefined]
+**base64** | **string** | Base64 인코딩된 파일 데이터. url이 없을 때 필수. 디코딩 후 최대 23MB. | [optional] [default to undefined]
+**url** | **string** | 다운로드 가능한 파일 URL. base64가 없을 때 필수. | [optional] [default to undefined]
 
 ## Example
 

package/docs/UploadUrlCreatedResponseDto.md

@@ -6,9 +6,9 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **fileKey** | **string** | 예약된 파일 키(영문 대소문자·숫자 32자). 업로드를 확정한 뒤 공고 등록·수정의 첨부에 이 값을 실으세요. | [default to undefined]
-**uploadUrl** | **string** | 파일 본문을 `PUT` 할 주소입니다. 이 요청은 c-market 을 거치지 않고 스토리지로 직접 갑니다. | [default to undefined]
-**expiresIn** | **number** | `uploadUrl` 의 유효 시간(초). 만료되면 발급부터 다시 하세요. | [default to undefined]
-**contentType** | **string** | `PUT` 요청의 `Content-Type` 헤더에 **그대로** 실어야 하는 값입니다. 다른 값을 보내면 저장소에 잘못된 MIME 이 박혀 내려받기 응답이 달라집니다. | [default to undefined]
+**uploadUrl** | **string** | 파일 본문을 `PUT` 할 주소입니다. 이 요청은 c-market을 거치지 않고 스토리지로 직접 갑니다. | [default to undefined]
+**expiresIn** | **number** | `uploadUrl`의 유효 시간(초). 만료되면 발급부터 다시 하세요. | [default to undefined]
+**contentType** | **string** | `PUT` 요청의 `Content-Type` 헤더에 **그대로** 실어야 하는 값입니다. 다른 값을 보내면 저장소에 잘못된 MIME이 박혀 내려받기 응답이 달라집니다. | [default to undefined]
 
 ## Example
 

package/docs/WebhookBidEventData.md

@@ -1,6 +1,6 @@
 # WebhookBidEventData
 
-공고 상태 전이 이벤트의 본문. 상세는 `GET /v2/bids/{bidId}` 가 SSOT 입니다.
+공고 상태 전이 이벤트의 본문. 상세는 `GET /v2/bids/{bidId}`가 SSOT입니다.
 
 ## Properties
 

package/docs/WebhookDeliveryDto.md

@@ -10,13 +10,13 @@ Name | Type | Description | Notes
 **eventId** | **string** | 이벤트 식별자. 재시도해도 같은 값이며 `X-CMarket-Event-Id` 헤더로 실려 갑니다 — 수신측 중복 제거 키로 쓰세요. | [default to undefined]
 **eventType** | **string** | 이벤트 타입. | [default to undefined]
 **status** | [**PartnerWebhookDeliveryStatus**](PartnerWebhookDeliveryStatus.md) | 전송 상태. `PENDING`=대기·재시도 예정, `DELIVERED`=2xx 수신, `FAILED`=실패했고 재시도가 남음, `EXHAUSTED`=재시도 소진(더 보내지 않음). | [default to undefined]
-**attempt** | **number** | 몇 번째 시도인가(1 부터). | [default to undefined]
+**attempt** | **number** | 몇 번째 시도인가(1부터). | [default to undefined]
 **payload** | **{ [key: string]: any; }** | 보낸(보낼) 이벤트 본문. 수신측이 실제로 받는 JSON 그대로입니다. | [default to undefined]
 **responseStatus** | **number** | 수신측이 돌려준 HTTP 상태. 아직 보내지 않았거나 연결 자체가 실패했으면 null. | [default to undefined]
 **responseBodyExcerpt** | **string** | 수신측 응답 본문 앞부분(진단용, 길이 제한). 없으면 null. | [default to undefined]
 **nextAttemptAt** | **string** | 다음 재시도 예정 일시(ISO 8601, UTC). 재시도 예정이 없으면 null. | [default to undefined]
 **createdAt** | **string** | 이 시도가 만들어진 일시(ISO 8601, UTC). | [default to undefined]
-**deliveredAt** | **string** | 2xx 를 받은 일시(ISO 8601, UTC). 성공하지 않았으면 null. | [default to undefined]
+**deliveredAt** | **string** | 2xx를 받은 일시(ISO 8601, UTC). 성공하지 않았으면 null. | [default to undefined]
 
 ## Example
 

package/docs/WebhookEndpointDto.md

@@ -8,13 +8,13 @@ Name | Type | Description | Notes
 **endpointId** | **string** | 구독 식별자. | [default to undefined]
 **url** | **string** | 이벤트를 받을 수신 주소(HTTPS). | [default to undefined]
 **eventTypes** | [**Array<PartnerWebhookEventType>**](PartnerWebhookEventType.md) | 구독한 이벤트 타입. | [default to undefined]
-**status** | [**PartnerWebhookEndpointStatus**](PartnerWebhookEndpointStatus.md) | 구독 상태. `DISABLED` 면 발송이 멈춘 상태이며 `PATCH … {\"status\":\"ACTIVE\"}` 로 되살립니다. | [default to undefined]
-**consecutiveFailures** | **number** | 연속 실패 횟수. 2xx 를 한 번 받으면 0 으로 돌아갑니다. 임계치에 닿으면 구독이 자동으로 `DISABLED` 됩니다. | [default to undefined]
+**status** | [**PartnerWebhookEndpointStatus**](PartnerWebhookEndpointStatus.md) | 구독 상태. `DISABLED` 면 발송이 멈춘 상태이며 `PATCH … {\"status\":\"ACTIVE\"}`로 되살립니다. | [default to undefined]
+**consecutiveFailures** | **number** | 연속 실패 횟수. 2xx를 한 번 받으면 0으로 돌아갑니다. 임계치에 닿으면 구독이 자동으로 `DISABLED` 됩니다. | [default to undefined]
 **secretVersion** | **number** | 서명 시크릿 세대. 재발급할 때마다 1 씩 올라갑니다 — 수신측이 어느 시크릿으로 검증해야 하는지 대조하는 용도입니다. | [default to undefined]
 **createdAt** | **string** | 등록 일시(ISO 8601, UTC). | [default to undefined]
 **updatedAt** | **string** | 최종 수정 일시(ISO 8601, UTC). | [default to undefined]
-**disabledAt** | **string** | `DISABLED` 로 내려간 일시(ISO 8601, UTC). 활성 구독이면 null. | [default to undefined]
-**lastSuccessAt** | **string** | 마지막으로 2xx 를 받은 일시(ISO 8601, UTC). 한 번도 성공한 적이 없으면 null. | [default to undefined]
+**disabledAt** | **string** | `DISABLED`로 내려간 일시(ISO 8601, UTC). 활성 구독이면 null. | [default to undefined]
+**lastSuccessAt** | **string** | 마지막으로 2xx를 받은 일시(ISO 8601, UTC). 한 번도 성공한 적이 없으면 null. | [default to undefined]
 
 ## Example
 

package/docs/WebhookEndpointWithSecretDto.md

@@ -8,13 +8,13 @@ Name | Type | Description | Notes
 **endpointId** | **string** | 구독 식별자. | [default to undefined]
 **url** | **string** | 이벤트를 받을 수신 주소(HTTPS). | [default to undefined]
 **eventTypes** | [**Array<PartnerWebhookEventType>**](PartnerWebhookEventType.md) | 구독한 이벤트 타입. | [default to undefined]
-**status** | [**PartnerWebhookEndpointStatus**](PartnerWebhookEndpointStatus.md) | 구독 상태. `DISABLED` 면 발송이 멈춘 상태이며 `PATCH … {\"status\":\"ACTIVE\"}` 로 되살립니다. | [default to undefined]
-**consecutiveFailures** | **number** | 연속 실패 횟수. 2xx 를 한 번 받으면 0 으로 돌아갑니다. 임계치에 닿으면 구독이 자동으로 `DISABLED` 됩니다. | [default to undefined]
+**status** | [**PartnerWebhookEndpointStatus**](PartnerWebhookEndpointStatus.md) | 구독 상태. `DISABLED` 면 발송이 멈춘 상태이며 `PATCH … {\"status\":\"ACTIVE\"}`로 되살립니다. | [default to undefined]
+**consecutiveFailures** | **number** | 연속 실패 횟수. 2xx를 한 번 받으면 0으로 돌아갑니다. 임계치에 닿으면 구독이 자동으로 `DISABLED` 됩니다. | [default to undefined]
 **secretVersion** | **number** | 서명 시크릿 세대. 재발급할 때마다 1 씩 올라갑니다 — 수신측이 어느 시크릿으로 검증해야 하는지 대조하는 용도입니다. | [default to undefined]
 **createdAt** | **string** | 등록 일시(ISO 8601, UTC). | [default to undefined]
 **updatedAt** | **string** | 최종 수정 일시(ISO 8601, UTC). | [default to undefined]
-**disabledAt** | **string** | `DISABLED` 로 내려간 일시(ISO 8601, UTC). 활성 구독이면 null. | [default to undefined]
-**lastSuccessAt** | **string** | 마지막으로 2xx 를 받은 일시(ISO 8601, UTC). 한 번도 성공한 적이 없으면 null. | [default to undefined]
+**disabledAt** | **string** | `DISABLED`로 내려간 일시(ISO 8601, UTC). 활성 구독이면 null. | [default to undefined]
+**lastSuccessAt** | **string** | 마지막으로 2xx를 받은 일시(ISO 8601, UTC). 한 번도 성공한 적이 없으면 null. | [default to undefined]
 **secret** | **string** | 서명 시크릿. `X-CMarket-Signature` 검증에 쓰며 **이 응답에서만** 확인할 수 있습니다. 안전한 곳에 즉시 보관하세요. | [default to undefined]
 
 ## Example

package/docs/WebhookEventEnvelope.md

@@ -1,6 +1,6 @@
 # WebhookEventEnvelope
 
-모든 웹훅 본문의 공통 봉투. 필드 순서가 곧 서명 대상 바이트 순서입니다.
+모든 웹훅 본문의 공통 형식. 필드 순서가 곧 서명 대상 바이트 순서입니다.
 
 ## Properties
 

package/docs/WebhookTestResultDto.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**delivered** | **boolean** | 수신측이 2xx 로 응답했는가. | [default to undefined]
+**delivered** | **boolean** | 수신측이 2xx로 응답했는가. | [default to undefined]
 **responseStatus** | **number** | 수신측이 돌려준 HTTP 상태. 연결 자체가 실패했으면 null. | [default to undefined]
 **error** | **string** | 실패 사유(연결 거부·타임아웃·TLS 오류 등). 성공했으면 null. 수신측 주소·방화벽·인증서를 확인하는 데 쓰세요. | [default to undefined]