@cmarket/partner-sdk 46.0.0 → 48.0.0

package/docs/WebhooksApi.md

@@ -1,403 +0,0 @@
-# WebhooksApi
-
-All URIs are relative to *https://partner-api.c-market.net*
-
-|Method | HTTP request | Description|
-|------------- | ------------- | -------------|
-|[**onBidAwardReverted**](#onbidawardreverted) | **POST** /bid.award_reverted | 운영자가 낙찰을 되돌렸습니다 — 이미 받은 `bid.awarded`를 무효로 취급하세요.|
-|[**onBidAwarded**](#onbidawarded) | **POST** /bid.awarded | 낙찰 확정.|
-|[**onBidCanceled**](#onbidcanceled) | **POST** /bid.canceled | 발주기관 또는 운영자의 공고 취소.|
-|[**onBidClosed**](#onbidclosed) | **POST** /bid.closed | 공고 마감 — 응찰 접수가 끝났습니다(낙찰자는 아직 정해지지 않았습니다).|
-|[**onBidFailed**](#onbidfailed) | **POST** /bid.failed | 유찰 확정.|
-|[**onPing**](#onping) | **POST** /ping | 연결 확인 발송. **구독할 수 없습니다** — `POST /v2/webhook-endpoints/{endpointId}/test`가 즉시 1회 보낼 때만 옵니다.|
-
-# **onBidAwardReverted**
-> onBidAwardReverted(onBidAwardRevertedRequest)
-
-운영자가 낙찰을 되돌렸습니다. **이미 받은 `bid.awarded`를 무효로 취급하세요** — 계약·정산을 이 공고로 진행했다면 되돌려야 합니다. 이후 다시 낙찰되면 `bid.awarded`가 새로 옵니다.
-
-### Example
-
-```typescript
-import {
-    WebhooksApi,
-    Configuration,
-    OnBidAwardRevertedRequest
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new WebhooksApi(configuration);
-
-let webhookId: string; //이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. (default to undefined)
-let webhookEventType: string; //이벤트 타입. 본문 `type`과 같습니다. (default to undefined)
-let webhookTimestamp: string; //서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. (default to undefined)
-let webhookSignature: string; //`v1,<base64 hmac-sha256>`(Standard Webhooks). 서명 대상은 `\"{webhook-id}.{webhook-timestamp}.{원문 본문}\"`이고, HMAC 키는 시크릿 문자열이 아니라 `whsec_`를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 `standardwebhooks` 라이브러리를 쓰는 것을 권합니다. (default to undefined)
-let onBidAwardRevertedRequest: OnBidAwardRevertedRequest; //
-
-const { status, data } = await apiInstance.onBidAwardReverted(
-    webhookId,
-    webhookEventType,
-    webhookTimestamp,
-    webhookSignature,
-    onBidAwardRevertedRequest
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **onBidAwardRevertedRequest** | **OnBidAwardRevertedRequest**|  | |
-| **webhookId** | [**string**] | 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. | defaults to undefined|
-| **webhookEventType** | [**string**] | 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다. | defaults to undefined|
-| **webhookTimestamp** | [**string**] | 서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. | defaults to undefined|
-| **webhookSignature** | [**string**] | &#x60;v1,&lt;base64 hmac-sha256&gt;&#x60;(Standard Webhooks). 서명 대상은 &#x60;\&quot;{webhook-id}.{webhook-timestamp}.{원문 본문}\&quot;&#x60;이고, HMAC 키는 시크릿 문자열이 아니라 &#x60;whsec_&#x60;를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 &#x60;standardwebhooks&#x60; 라이브러리를 쓰는 것을 권합니다. | defaults to undefined|
-
-
-### Return type
-
-void (empty response body)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: Not defined
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 수신 성공. **2xx 면 무엇이든 성공**으로 기록합니다. 본문은 읽지 않으므로 비워도 됩니다. 처리에 시간이 걸리면 먼저 2xx로 응답하고 비동기로 처리하세요 — 응답이 늦으면 타임아웃으로 재시도가 걸립니다. |  -  |
-|**0** | 2xx가 아니면 실패로 기록하고 재시도합니다(7회, 간격 10·60·300·1800·7200·21600·86400초). 연속 실패가 20회에 도달하면 구독이 &#x60;DISABLED&#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)
-
-# **onBidAwarded**
-> onBidAwarded(onBidAwardedRequest)
-
-낙찰이 확정됐습니다. 낙찰자는 `GET /v2/bid-results`의 `participants[].isWinner`로 읽으세요 — **공고 상태로 판정하지 마세요.** `AWARDED` 라는 상태는 존재하지 않고 낙찰 직후 `CONTRACT_IN_PROGRESS`로 전이합니다. 낙찰방법이 다수업체 선정이면 `isWinner` 가 여럿일 수 있습니다.
-
-### Example
-
-```typescript
-import {
-    WebhooksApi,
-    Configuration,
-    OnBidAwardedRequest
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new WebhooksApi(configuration);
-
-let webhookId: string; //이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. (default to undefined)
-let webhookEventType: string; //이벤트 타입. 본문 `type`과 같습니다. (default to undefined)
-let webhookTimestamp: string; //서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. (default to undefined)
-let webhookSignature: string; //`v1,<base64 hmac-sha256>`(Standard Webhooks). 서명 대상은 `\"{webhook-id}.{webhook-timestamp}.{원문 본문}\"`이고, HMAC 키는 시크릿 문자열이 아니라 `whsec_`를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 `standardwebhooks` 라이브러리를 쓰는 것을 권합니다. (default to undefined)
-let onBidAwardedRequest: OnBidAwardedRequest; //
-
-const { status, data } = await apiInstance.onBidAwarded(
-    webhookId,
-    webhookEventType,
-    webhookTimestamp,
-    webhookSignature,
-    onBidAwardedRequest
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **onBidAwardedRequest** | **OnBidAwardedRequest**|  | |
-| **webhookId** | [**string**] | 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. | defaults to undefined|
-| **webhookEventType** | [**string**] | 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다. | defaults to undefined|
-| **webhookTimestamp** | [**string**] | 서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. | defaults to undefined|
-| **webhookSignature** | [**string**] | &#x60;v1,&lt;base64 hmac-sha256&gt;&#x60;(Standard Webhooks). 서명 대상은 &#x60;\&quot;{webhook-id}.{webhook-timestamp}.{원문 본문}\&quot;&#x60;이고, HMAC 키는 시크릿 문자열이 아니라 &#x60;whsec_&#x60;를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 &#x60;standardwebhooks&#x60; 라이브러리를 쓰는 것을 권합니다. | defaults to undefined|
-
-
-### Return type
-
-void (empty response body)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: Not defined
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 수신 성공. **2xx 면 무엇이든 성공**으로 기록합니다. 본문은 읽지 않으므로 비워도 됩니다. 처리에 시간이 걸리면 먼저 2xx로 응답하고 비동기로 처리하세요 — 응답이 늦으면 타임아웃으로 재시도가 걸립니다. |  -  |
-|**0** | 2xx가 아니면 실패로 기록하고 재시도합니다(7회, 간격 10·60·300·1800·7200·21600·86400초). 연속 실패가 20회에 도달하면 구독이 &#x60;DISABLED&#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)
-
-# **onBidCanceled**
-> onBidCanceled(onBidCanceledRequest)
-
-공고가 취소됐습니다. 진행 중이던 절차를 중단하세요. 취소는 마감 전후 어느 시점에도 올 수 있고, 이미 `bid.closed`를 받은 뒤에도 옵니다.
-
-### Example
-
-```typescript
-import {
-    WebhooksApi,
-    Configuration,
-    OnBidCanceledRequest
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new WebhooksApi(configuration);
-
-let webhookId: string; //이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. (default to undefined)
-let webhookEventType: string; //이벤트 타입. 본문 `type`과 같습니다. (default to undefined)
-let webhookTimestamp: string; //서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. (default to undefined)
-let webhookSignature: string; //`v1,<base64 hmac-sha256>`(Standard Webhooks). 서명 대상은 `\"{webhook-id}.{webhook-timestamp}.{원문 본문}\"`이고, HMAC 키는 시크릿 문자열이 아니라 `whsec_`를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 `standardwebhooks` 라이브러리를 쓰는 것을 권합니다. (default to undefined)
-let onBidCanceledRequest: OnBidCanceledRequest; //
-
-const { status, data } = await apiInstance.onBidCanceled(
-    webhookId,
-    webhookEventType,
-    webhookTimestamp,
-    webhookSignature,
-    onBidCanceledRequest
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **onBidCanceledRequest** | **OnBidCanceledRequest**|  | |
-| **webhookId** | [**string**] | 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. | defaults to undefined|
-| **webhookEventType** | [**string**] | 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다. | defaults to undefined|
-| **webhookTimestamp** | [**string**] | 서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. | defaults to undefined|
-| **webhookSignature** | [**string**] | &#x60;v1,&lt;base64 hmac-sha256&gt;&#x60;(Standard Webhooks). 서명 대상은 &#x60;\&quot;{webhook-id}.{webhook-timestamp}.{원문 본문}\&quot;&#x60;이고, HMAC 키는 시크릿 문자열이 아니라 &#x60;whsec_&#x60;를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 &#x60;standardwebhooks&#x60; 라이브러리를 쓰는 것을 권합니다. | defaults to undefined|
-
-
-### Return type
-
-void (empty response body)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: Not defined
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 수신 성공. **2xx 면 무엇이든 성공**으로 기록합니다. 본문은 읽지 않으므로 비워도 됩니다. 처리에 시간이 걸리면 먼저 2xx로 응답하고 비동기로 처리하세요 — 응답이 늦으면 타임아웃으로 재시도가 걸립니다. |  -  |
-|**0** | 2xx가 아니면 실패로 기록하고 재시도합니다(7회, 간격 10·60·300·1800·7200·21600·86400초). 연속 실패가 20회에 도달하면 구독이 &#x60;DISABLED&#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)
-
-# **onBidClosed**
-> onBidClosed(onBidClosedRequest)
-
-응찰 접수가 끝났습니다. **낙찰자는 아직 없습니다** — 이 시점에 결과를 물으면 빈 값을 받습니다. 낙찰이 확정되면 `bid.awarded`가 따로 옵니다.
-
-### Example
-
-```typescript
-import {
-    WebhooksApi,
-    Configuration,
-    OnBidClosedRequest
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new WebhooksApi(configuration);
-
-let webhookId: string; //이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. (default to undefined)
-let webhookEventType: string; //이벤트 타입. 본문 `type`과 같습니다. (default to undefined)
-let webhookTimestamp: string; //서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. (default to undefined)
-let webhookSignature: string; //`v1,<base64 hmac-sha256>`(Standard Webhooks). 서명 대상은 `\"{webhook-id}.{webhook-timestamp}.{원문 본문}\"`이고, HMAC 키는 시크릿 문자열이 아니라 `whsec_`를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 `standardwebhooks` 라이브러리를 쓰는 것을 권합니다. (default to undefined)
-let onBidClosedRequest: OnBidClosedRequest; //
-
-const { status, data } = await apiInstance.onBidClosed(
-    webhookId,
-    webhookEventType,
-    webhookTimestamp,
-    webhookSignature,
-    onBidClosedRequest
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **onBidClosedRequest** | **OnBidClosedRequest**|  | |
-| **webhookId** | [**string**] | 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. | defaults to undefined|
-| **webhookEventType** | [**string**] | 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다. | defaults to undefined|
-| **webhookTimestamp** | [**string**] | 서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. | defaults to undefined|
-| **webhookSignature** | [**string**] | &#x60;v1,&lt;base64 hmac-sha256&gt;&#x60;(Standard Webhooks). 서명 대상은 &#x60;\&quot;{webhook-id}.{webhook-timestamp}.{원문 본문}\&quot;&#x60;이고, HMAC 키는 시크릿 문자열이 아니라 &#x60;whsec_&#x60;를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 &#x60;standardwebhooks&#x60; 라이브러리를 쓰는 것을 권합니다. | defaults to undefined|
-
-
-### Return type
-
-void (empty response body)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: Not defined
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 수신 성공. **2xx 면 무엇이든 성공**으로 기록합니다. 본문은 읽지 않으므로 비워도 됩니다. 처리에 시간이 걸리면 먼저 2xx로 응답하고 비동기로 처리하세요 — 응답이 늦으면 타임아웃으로 재시도가 걸립니다. |  -  |
-|**0** | 2xx가 아니면 실패로 기록하고 재시도합니다(7회, 간격 10·60·300·1800·7200·21600·86400초). 연속 실패가 20회에 도달하면 구독이 &#x60;DISABLED&#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)
-
-# **onBidFailed**
-> onBidFailed(onBidFailedRequest)
-
-유찰이 확정됐습니다(낙찰자 없이 종료). 재공고 여부는 발주기관 판단이며 그때 새 공고번호로 새 이벤트가 옵니다 — 이 공고를 기다리지 마세요.
-
-### Example
-
-```typescript
-import {
-    WebhooksApi,
-    Configuration,
-    OnBidFailedRequest
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new WebhooksApi(configuration);
-
-let webhookId: string; //이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. (default to undefined)
-let webhookEventType: string; //이벤트 타입. 본문 `type`과 같습니다. (default to undefined)
-let webhookTimestamp: string; //서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. (default to undefined)
-let webhookSignature: string; //`v1,<base64 hmac-sha256>`(Standard Webhooks). 서명 대상은 `\"{webhook-id}.{webhook-timestamp}.{원문 본문}\"`이고, HMAC 키는 시크릿 문자열이 아니라 `whsec_`를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 `standardwebhooks` 라이브러리를 쓰는 것을 권합니다. (default to undefined)
-let onBidFailedRequest: OnBidFailedRequest; //
-
-const { status, data } = await apiInstance.onBidFailed(
-    webhookId,
-    webhookEventType,
-    webhookTimestamp,
-    webhookSignature,
-    onBidFailedRequest
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **onBidFailedRequest** | **OnBidFailedRequest**|  | |
-| **webhookId** | [**string**] | 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. | defaults to undefined|
-| **webhookEventType** | [**string**] | 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다. | defaults to undefined|
-| **webhookTimestamp** | [**string**] | 서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. | defaults to undefined|
-| **webhookSignature** | [**string**] | &#x60;v1,&lt;base64 hmac-sha256&gt;&#x60;(Standard Webhooks). 서명 대상은 &#x60;\&quot;{webhook-id}.{webhook-timestamp}.{원문 본문}\&quot;&#x60;이고, HMAC 키는 시크릿 문자열이 아니라 &#x60;whsec_&#x60;를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 &#x60;standardwebhooks&#x60; 라이브러리를 쓰는 것을 권합니다. | defaults to undefined|
-
-
-### Return type
-
-void (empty response body)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: Not defined
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 수신 성공. **2xx 면 무엇이든 성공**으로 기록합니다. 본문은 읽지 않으므로 비워도 됩니다. 처리에 시간이 걸리면 먼저 2xx로 응답하고 비동기로 처리하세요 — 응답이 늦으면 타임아웃으로 재시도가 걸립니다. |  -  |
-|**0** | 2xx가 아니면 실패로 기록하고 재시도합니다(7회, 간격 10·60·300·1800·7200·21600·86400초). 연속 실패가 20회에 도달하면 구독이 &#x60;DISABLED&#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)
-
-# **onPing**
-> onPing(onPingRequest)
-
-수신 주소와 서명 검증이 실제로 동작하는지 확인하는 발송입니다. 본문에는 확인을 요청한 구독 식별자만 담기고 공고 정보는 없습니다 — 처리하지 말고 2xx만 돌려주면 됩니다. 구독 대상이 아니므로 `eventTypes`에 넣으면 400입니다.
-
-### Example
-
-```typescript
-import {
-    WebhooksApi,
-    Configuration,
-    OnPingRequest
-} from '@cmarket/partner-sdk';
-
-const configuration = new Configuration();
-const apiInstance = new WebhooksApi(configuration);
-
-let webhookId: string; //이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. (default to undefined)
-let webhookEventType: string; //이벤트 타입. 본문 `type`과 같습니다. (default to undefined)
-let webhookTimestamp: string; //서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. (default to undefined)
-let webhookSignature: string; //`v1,<base64 hmac-sha256>`(Standard Webhooks). 서명 대상은 `\"{webhook-id}.{webhook-timestamp}.{원문 본문}\"`이고, HMAC 키는 시크릿 문자열이 아니라 `whsec_`를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 `standardwebhooks` 라이브러리를 쓰는 것을 권합니다. (default to undefined)
-let onPingRequest: OnPingRequest; //
-
-const { status, data } = await apiInstance.onPing(
-    webhookId,
-    webhookEventType,
-    webhookTimestamp,
-    webhookSignature,
-    onPingRequest
-);
-```
-
-### Parameters
-
-|Name | Type | Description  | Notes|
-|------------- | ------------- | ------------- | -------------|
-| **onPingRequest** | **OnPingRequest**|  | |
-| **webhookId** | [**string**] | 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요. | defaults to undefined|
-| **webhookEventType** | [**string**] | 이벤트 타입. 본문 &#x60;type&#x60;과 같습니다. | defaults to undefined|
-| **webhookTimestamp** | [**string**] | 서명 타임스탬프(unix 초). 현재 시각에서 300초 이상 지난 요청은 재전송으로 보고 거절하세요. | defaults to undefined|
-| **webhookSignature** | [**string**] | &#x60;v1,&lt;base64 hmac-sha256&gt;&#x60;(Standard Webhooks). 서명 대상은 &#x60;\&quot;{webhook-id}.{webhook-timestamp}.{원문 본문}\&quot;&#x60;이고, HMAC 키는 시크릿 문자열이 아니라 &#x60;whsec_&#x60;를 뗀 뒤 base64 디코드한 바이트입니다. 공백으로 구분된 여러 서명이 올 수 있으니(키 회전) **하나라도 맞으면 통과**로 처리하세요. 직접 구현하지 말고 각 언어의 &#x60;standardwebhooks&#x60; 라이브러리를 쓰는 것을 권합니다. | defaults to undefined|
-
-
-### Return type
-
-void (empty response body)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
- - **Content-Type**: application/json
- - **Accept**: Not defined
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-|**200** | 수신 성공. **2xx 면 무엇이든 성공**으로 기록합니다. 본문은 읽지 않으므로 비워도 됩니다. 처리에 시간이 걸리면 먼저 2xx로 응답하고 비동기로 처리하세요 — 응답이 늦으면 타임아웃으로 재시도가 걸립니다. |  -  |
-|**0** | 2xx가 아니면 실패로 기록하고 재시도합니다(7회, 간격 10·60·300·1800·7200·21600·86400초). 연속 실패가 20회에 도달하면 구독이 &#x60;DISABLED&#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)
-

package/models/cancel-kcl-mro-order-request-dto.ts

@@ -1,21 +0,0 @@
-/* tslint:disable */
-/* 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 확장, 값 없음). - `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: 46.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-
-
-
-export interface CancelKclMroOrderRequestDto {
-    'orderNo': string;
-    'buyerMemberId': string;
-}
-

package/models/cancel-kcl-mro-order-response-dto.ts

@@ -1,23 +0,0 @@
-/* tslint:disable */
-/* 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 확장, 값 없음). - `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: 46.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-
-
-
-export interface CancelKclMroOrderResponseDto {
-    /**
-     * 취소 표시에 성공했습니다. 이미 구매요구가 채번된 주문은 false 로 돌아옵니다 — 그때는 기관 ERP 안에서 결재가 진행 중입니다.
-     */
-    'canceled': boolean;
-}
-

package/models/cancel-kcl-mro-order200-response.ts

@@ -1,23 +0,0 @@
-/* tslint:disable */
-/* 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 확장, 값 없음). - `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: 46.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-
-
-// May contain unused imports in some cases
-// @ts-ignore
-import type { CancelKclMroOrderResponseDto } from './cancel-kcl-mro-order-response-dto';
-
-export interface CancelKclMroOrder200Response {
-    'data': CancelKclMroOrderResponseDto;
-}
-

package/models/create-webhook-endpoint-request-dto.ts

@@ -1,30 +0,0 @@
-/* tslint:disable */
-/* 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 확장, 값 없음). - `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: 46.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-
-
-// May contain unused imports in some cases
-// @ts-ignore
-import type { PartnerWebhookEventType } from './partner-webhook-event-type';
-
-export interface CreateWebhookEndpointRequestDto {
-    /**
-     * 이벤트를 받을 수신 주소. **HTTPS만 허용합니다** — 서명된 페이로드를 평문 구간에 실을 수 없습니다.
-     */
-    'url': string;
-    /**
-     * 구독할 이벤트 타입. 최소 1개, 중복 불가. `ping`은 연결 확인 전용이라 구독할 수 없습니다.
-     */
-    'eventTypes': Set<PartnerWebhookEventType>;
-}
-

package/models/create-webhook-endpoint201-response.ts

@@ -1,23 +0,0 @@
-/* tslint:disable */
-/* 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 확장, 값 없음). - `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: 46.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-
-
-// May contain unused imports in some cases
-// @ts-ignore
-import type { WebhookEndpointWithSecretDto } from './webhook-endpoint-with-secret-dto';
-
-export interface CreateWebhookEndpoint201Response {
-    'data': WebhookEndpointWithSecretDto;
-}
-

package/models/file-meta-response-dto.ts

@@ -1,39 +0,0 @@
-/* tslint:disable */
-/* 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 확장, 값 없음). - `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: 46.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-
-
-
-export interface FileMetaResponseDto {
-    /**
-     * 파일 키(영문 대소문자·숫자 32자). 요청한 값이 아니라 저장소의 정규 키입니다.
-     */
-    'fileKey': string;
-    /**
-     * 원본 파일명.
-     */
-    'fileName': string;
-    /**
-     * 파일 크기(바이트).
-     */
-    'fileSize': number;
-    /**
-     * 업로드 일시(ISO 8601 UTC).
-     */
-    'uploadedAt': string;
-    /**
-     * 내려받기 주소입니다. 요청 시점에 서명하므로 유효기간이 있습니다 — 저장해 두지 마시고 필요할 때 이 조회를 다시 호출하세요.
-     */
-    'downloadUrl': string;
-}
-