@cmarket/partner-sdk 31.1.0 → 31.2.0

package/api/webhooks-api.ts

@@ -0,0 +1,636 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * CMARKET V6 Partner API
+ * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다. 호출 횟수 자체를 줄이려면 웹훅을 사용하세요.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP 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` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
+ *
+ * The version of the OpenAPI document: 31.2.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.
+ */
+
+
+import type { Configuration } from '../configuration';
+import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
+import globalAxios from 'axios';
+// Some imports not used depending on template conditions
+// @ts-ignore
+import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObject, setBearerAuthToObject, setOAuthToObject, setSearchParams, serializeDataIfNeeded, toPathString, createRequestFunction, replaceWithSerializableTypeIfNeeded } from '../common';
+// @ts-ignore
+import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError, operationServerMap } from '../base';
+// @ts-ignore
+import type { OnBidAwardRevertedRequest } from '../models';
+// @ts-ignore
+import type { OnBidAwardedRequest } from '../models';
+// @ts-ignore
+import type { OnBidCanceledRequest } from '../models';
+// @ts-ignore
+import type { OnBidClosedRequest } from '../models';
+// @ts-ignore
+import type { OnBidFailedRequest } from '../models';
+// @ts-ignore
+import type { OnPingRequest } from '../models';
+/**
+ * WebhooksApi - axios parameter creator
+ */
+export const WebhooksApiAxiosParamCreator = function (configuration?: Configuration) {
+    return {
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 운영자가 낙찰을 되돌렸습니다 — 이미 받은 `bid.awarded` 를 무효로 취급하세요.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidAwardRevertedRequest} onBidAwardRevertedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidAwardReverted: async (xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidAwardRevertedRequest: OnBidAwardRevertedRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'xCMarketEventId' is not null or undefined
+            assertParamExists('onBidAwardReverted', 'xCMarketEventId', xCMarketEventId)
+            // verify required parameter 'xCMarketEventType' is not null or undefined
+            assertParamExists('onBidAwardReverted', 'xCMarketEventType', xCMarketEventType)
+            // verify required parameter 'xCMarketSignature' is not null or undefined
+            assertParamExists('onBidAwardReverted', 'xCMarketSignature', xCMarketSignature)
+            // verify required parameter 'onBidAwardRevertedRequest' is not null or undefined
+            assertParamExists('onBidAwardReverted', 'onBidAwardRevertedRequest', onBidAwardRevertedRequest)
+            const localVarPath = `/bid.award_reverted`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            if (xCMarketEventId != null) {
+                localVarHeaderParameter['X-CMarket-Event-Id'] = String(xCMarketEventId);
+            }
+            if (xCMarketEventType != null) {
+                localVarHeaderParameter['X-CMarket-Event-Type'] = String(xCMarketEventType);
+            }
+            if (xCMarketSignature != null) {
+                localVarHeaderParameter['X-CMarket-Signature'] = String(xCMarketSignature);
+            }
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(onBidAwardRevertedRequest, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 낙찰 확정.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidAwardedRequest} onBidAwardedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidAwarded: async (xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidAwardedRequest: OnBidAwardedRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'xCMarketEventId' is not null or undefined
+            assertParamExists('onBidAwarded', 'xCMarketEventId', xCMarketEventId)
+            // verify required parameter 'xCMarketEventType' is not null or undefined
+            assertParamExists('onBidAwarded', 'xCMarketEventType', xCMarketEventType)
+            // verify required parameter 'xCMarketSignature' is not null or undefined
+            assertParamExists('onBidAwarded', 'xCMarketSignature', xCMarketSignature)
+            // verify required parameter 'onBidAwardedRequest' is not null or undefined
+            assertParamExists('onBidAwarded', 'onBidAwardedRequest', onBidAwardedRequest)
+            const localVarPath = `/bid.awarded`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            if (xCMarketEventId != null) {
+                localVarHeaderParameter['X-CMarket-Event-Id'] = String(xCMarketEventId);
+            }
+            if (xCMarketEventType != null) {
+                localVarHeaderParameter['X-CMarket-Event-Type'] = String(xCMarketEventType);
+            }
+            if (xCMarketSignature != null) {
+                localVarHeaderParameter['X-CMarket-Signature'] = String(xCMarketSignature);
+            }
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(onBidAwardedRequest, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 발주기관 또는 운영자의 공고 취소.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidCanceledRequest} onBidCanceledRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidCanceled: async (xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidCanceledRequest: OnBidCanceledRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'xCMarketEventId' is not null or undefined
+            assertParamExists('onBidCanceled', 'xCMarketEventId', xCMarketEventId)
+            // verify required parameter 'xCMarketEventType' is not null or undefined
+            assertParamExists('onBidCanceled', 'xCMarketEventType', xCMarketEventType)
+            // verify required parameter 'xCMarketSignature' is not null or undefined
+            assertParamExists('onBidCanceled', 'xCMarketSignature', xCMarketSignature)
+            // verify required parameter 'onBidCanceledRequest' is not null or undefined
+            assertParamExists('onBidCanceled', 'onBidCanceledRequest', onBidCanceledRequest)
+            const localVarPath = `/bid.canceled`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            if (xCMarketEventId != null) {
+                localVarHeaderParameter['X-CMarket-Event-Id'] = String(xCMarketEventId);
+            }
+            if (xCMarketEventType != null) {
+                localVarHeaderParameter['X-CMarket-Event-Type'] = String(xCMarketEventType);
+            }
+            if (xCMarketSignature != null) {
+                localVarHeaderParameter['X-CMarket-Signature'] = String(xCMarketSignature);
+            }
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(onBidCanceledRequest, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 공고 마감 — 응찰 접수가 끝났습니다(낙찰자는 아직 정해지지 않았습니다).
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidClosedRequest} onBidClosedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidClosed: async (xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidClosedRequest: OnBidClosedRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'xCMarketEventId' is not null or undefined
+            assertParamExists('onBidClosed', 'xCMarketEventId', xCMarketEventId)
+            // verify required parameter 'xCMarketEventType' is not null or undefined
+            assertParamExists('onBidClosed', 'xCMarketEventType', xCMarketEventType)
+            // verify required parameter 'xCMarketSignature' is not null or undefined
+            assertParamExists('onBidClosed', 'xCMarketSignature', xCMarketSignature)
+            // verify required parameter 'onBidClosedRequest' is not null or undefined
+            assertParamExists('onBidClosed', 'onBidClosedRequest', onBidClosedRequest)
+            const localVarPath = `/bid.closed`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            if (xCMarketEventId != null) {
+                localVarHeaderParameter['X-CMarket-Event-Id'] = String(xCMarketEventId);
+            }
+            if (xCMarketEventType != null) {
+                localVarHeaderParameter['X-CMarket-Event-Type'] = String(xCMarketEventType);
+            }
+            if (xCMarketSignature != null) {
+                localVarHeaderParameter['X-CMarket-Signature'] = String(xCMarketSignature);
+            }
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(onBidClosedRequest, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 유찰 확정.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidFailedRequest} onBidFailedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidFailed: async (xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidFailedRequest: OnBidFailedRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'xCMarketEventId' is not null or undefined
+            assertParamExists('onBidFailed', 'xCMarketEventId', xCMarketEventId)
+            // verify required parameter 'xCMarketEventType' is not null or undefined
+            assertParamExists('onBidFailed', 'xCMarketEventType', xCMarketEventType)
+            // verify required parameter 'xCMarketSignature' is not null or undefined
+            assertParamExists('onBidFailed', 'xCMarketSignature', xCMarketSignature)
+            // verify required parameter 'onBidFailedRequest' is not null or undefined
+            assertParamExists('onBidFailed', 'onBidFailedRequest', onBidFailedRequest)
+            const localVarPath = `/bid.failed`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            if (xCMarketEventId != null) {
+                localVarHeaderParameter['X-CMarket-Event-Id'] = String(xCMarketEventId);
+            }
+            if (xCMarketEventType != null) {
+                localVarHeaderParameter['X-CMarket-Event-Type'] = String(xCMarketEventType);
+            }
+            if (xCMarketSignature != null) {
+                localVarHeaderParameter['X-CMarket-Signature'] = String(xCMarketSignature);
+            }
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(onBidFailedRequest, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 연결 확인 발송. **구독할 수 없습니다** — `POST /v2/webhook-endpoints/{endpointId}/test` 가 즉시 1회 보낼 때만 옵니다.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnPingRequest} onPingRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onPing: async (xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onPingRequest: OnPingRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'xCMarketEventId' is not null or undefined
+            assertParamExists('onPing', 'xCMarketEventId', xCMarketEventId)
+            // verify required parameter 'xCMarketEventType' is not null or undefined
+            assertParamExists('onPing', 'xCMarketEventType', xCMarketEventType)
+            // verify required parameter 'xCMarketSignature' is not null or undefined
+            assertParamExists('onPing', 'xCMarketSignature', xCMarketSignature)
+            // verify required parameter 'onPingRequest' is not null or undefined
+            assertParamExists('onPing', 'onPingRequest', onPingRequest)
+            const localVarPath = `/ping`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            if (xCMarketEventId != null) {
+                localVarHeaderParameter['X-CMarket-Event-Id'] = String(xCMarketEventId);
+            }
+            if (xCMarketEventType != null) {
+                localVarHeaderParameter['X-CMarket-Event-Type'] = String(xCMarketEventType);
+            }
+            if (xCMarketSignature != null) {
+                localVarHeaderParameter['X-CMarket-Signature'] = String(xCMarketSignature);
+            }
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(onPingRequest, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+    }
+};
+
+/**
+ * WebhooksApi - functional programming interface
+ */
+export const WebhooksApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = WebhooksApiAxiosParamCreator(configuration)
+    return {
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 운영자가 낙찰을 되돌렸습니다 — 이미 받은 `bid.awarded` 를 무효로 취급하세요.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidAwardRevertedRequest} onBidAwardRevertedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async onBidAwardReverted(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidAwardRevertedRequest: OnBidAwardRevertedRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.onBidAwardReverted(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidAwardRevertedRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['WebhooksApi.onBidAwardReverted']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 낙찰 확정.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidAwardedRequest} onBidAwardedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async onBidAwarded(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidAwardedRequest: OnBidAwardedRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.onBidAwarded(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidAwardedRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['WebhooksApi.onBidAwarded']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 발주기관 또는 운영자의 공고 취소.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidCanceledRequest} onBidCanceledRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async onBidCanceled(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidCanceledRequest: OnBidCanceledRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.onBidCanceled(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidCanceledRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['WebhooksApi.onBidCanceled']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 공고 마감 — 응찰 접수가 끝났습니다(낙찰자는 아직 정해지지 않았습니다).
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidClosedRequest} onBidClosedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async onBidClosed(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidClosedRequest: OnBidClosedRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.onBidClosed(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidClosedRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['WebhooksApi.onBidClosed']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 유찰 확정.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidFailedRequest} onBidFailedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async onBidFailed(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidFailedRequest: OnBidFailedRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.onBidFailed(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidFailedRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['WebhooksApi.onBidFailed']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 연결 확인 발송. **구독할 수 없습니다** — `POST /v2/webhook-endpoints/{endpointId}/test` 가 즉시 1회 보낼 때만 옵니다.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnPingRequest} onPingRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async onPing(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onPingRequest: OnPingRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.onPing(xCMarketEventId, xCMarketEventType, xCMarketSignature, onPingRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['WebhooksApi.onPing']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+    }
+};
+
+/**
+ * WebhooksApi - factory interface
+ */
+export const WebhooksApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = WebhooksApiFp(configuration)
+    return {
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 운영자가 낙찰을 되돌렸습니다 — 이미 받은 `bid.awarded` 를 무효로 취급하세요.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidAwardRevertedRequest} onBidAwardRevertedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidAwardReverted(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidAwardRevertedRequest: OnBidAwardRevertedRequest, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.onBidAwardReverted(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidAwardRevertedRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 낙찰 확정.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidAwardedRequest} onBidAwardedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidAwarded(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidAwardedRequest: OnBidAwardedRequest, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.onBidAwarded(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidAwardedRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 발주기관 또는 운영자의 공고 취소.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidCanceledRequest} onBidCanceledRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidCanceled(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidCanceledRequest: OnBidCanceledRequest, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.onBidCanceled(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidCanceledRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 공고 마감 — 응찰 접수가 끝났습니다(낙찰자는 아직 정해지지 않았습니다).
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidClosedRequest} onBidClosedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidClosed(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidClosedRequest: OnBidClosedRequest, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.onBidClosed(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidClosedRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 유찰 확정.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnBidFailedRequest} onBidFailedRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onBidFailed(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidFailedRequest: OnBidFailedRequest, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.onBidFailed(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidFailedRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+         * @summary 연결 확인 발송. **구독할 수 없습니다** — `POST /v2/webhook-endpoints/{endpointId}/test` 가 즉시 1회 보낼 때만 옵니다.
+         * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+         * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+         * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+         * @param {OnPingRequest} onPingRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        onPing(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onPingRequest: OnPingRequest, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.onPing(xCMarketEventId, xCMarketEventType, xCMarketSignature, onPingRequest, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+
+/**
+ * WebhooksApi - object-oriented interface
+ */
+export class WebhooksApi extends BaseAPI {
+    /**
+     * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+     * @summary 운영자가 낙찰을 되돌렸습니다 — 이미 받은 `bid.awarded` 를 무효로 취급하세요.
+     * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+     * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+     * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+     * @param {OnBidAwardRevertedRequest} onBidAwardRevertedRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public onBidAwardReverted(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidAwardRevertedRequest: OnBidAwardRevertedRequest, options?: RawAxiosRequestConfig) {
+        return WebhooksApiFp(this.configuration).onBidAwardReverted(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidAwardRevertedRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+     * @summary 낙찰 확정.
+     * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+     * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+     * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+     * @param {OnBidAwardedRequest} onBidAwardedRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public onBidAwarded(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidAwardedRequest: OnBidAwardedRequest, options?: RawAxiosRequestConfig) {
+        return WebhooksApiFp(this.configuration).onBidAwarded(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidAwardedRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+     * @summary 발주기관 또는 운영자의 공고 취소.
+     * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+     * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+     * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+     * @param {OnBidCanceledRequest} onBidCanceledRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public onBidCanceled(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidCanceledRequest: OnBidCanceledRequest, options?: RawAxiosRequestConfig) {
+        return WebhooksApiFp(this.configuration).onBidCanceled(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidCanceledRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+     * @summary 공고 마감 — 응찰 접수가 끝났습니다(낙찰자는 아직 정해지지 않았습니다).
+     * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+     * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+     * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+     * @param {OnBidClosedRequest} onBidClosedRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public onBidClosed(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidClosedRequest: OnBidClosedRequest, options?: RawAxiosRequestConfig) {
+        return WebhooksApiFp(this.configuration).onBidClosed(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidClosedRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+     * @summary 유찰 확정.
+     * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+     * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+     * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+     * @param {OnBidFailedRequest} onBidFailedRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public onBidFailed(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onBidFailedRequest: OnBidFailedRequest, options?: RawAxiosRequestConfig) {
+        return WebhooksApiFp(this.configuration).onBidFailed(xCMarketEventId, xCMarketEventType, xCMarketSignature, onBidFailedRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * 발송자 User-Agent 는 `cmarket-webhooks/1` 입니다.  **서명 검증은 원문 바이트로 하세요.** JSON 을 파싱한 뒤 다시 직렬화하면 키 순서·공백이 달라져 서명이 어긋납니다.  **재시도는 at-least-once 입니다.** 같은 이벤트가 두 번 올 수 있으니 `X-CMarket-Event-Id` 로 중복 제거하세요.  **본문에는 최소 정보만 담깁니다.** 상세는 이벤트를 받은 뒤 해당 조회 엔드포인트로 가져오세요 — 같은 사실을 두 곳이 각자 표현하면 갈라집니다.
+     * @summary 연결 확인 발송. **구독할 수 없습니다** — `POST /v2/webhook-endpoints/{endpointId}/test` 가 즉시 1회 보낼 때만 옵니다.
+     * @param {string} xCMarketEventId 이벤트 식별자. **재시도에도 같은 값**이므로 수신측 중복 제거 키로 쓰세요.
+     * @param {string} xCMarketEventType 이벤트 타입. 본문 &#x60;type&#x60; 과 같습니다.
+     * @param {string} xCMarketSignature &#x60;t&#x3D;&lt;unix초&gt;,v1&#x3D;&lt;hex hmac-sha256&gt;&#x60;. 서명 대상은 &#x60;\&quot;{t}.{원문 본문}\&quot;&#x60; 이며, &#x60;t&#x60; 가 300초 이상 지난 요청은 재전송으로 보고 거절하세요.
+     * @param {OnPingRequest} onPingRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public onPing(xCMarketEventId: string, xCMarketEventType: string, xCMarketSignature: string, onPingRequest: OnPingRequest, options?: RawAxiosRequestConfig) {
+        return WebhooksApiFp(this.configuration).onPing(xCMarketEventId, xCMarketEventType, xCMarketSignature, onPingRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+