@cmarket/partner-sdk 33.1.0 → 35.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (940) hide show
  1. package/README.md +14 -65
  2. package/api/oauth-api.ts +2 -2
  3. package/api/partner-v1-api.ts +2 -2
  4. package/api/partner-v2-api.ts +243 -1494
  5. package/api/well-known-api.ts +2 -2
  6. package/api.ts +2 -2
  7. package/base.ts +2 -2
  8. package/common.ts +2 -2
  9. package/configuration.ts +2 -2
  10. package/dist/api/oauth-api.d.ts +2 -2
  11. package/dist/api/oauth-api.js +2 -2
  12. package/dist/api/partner-v1-api.d.ts +2 -2
  13. package/dist/api/partner-v1-api.js +2 -2
  14. package/dist/api/partner-v2-api.d.ts +122 -678
  15. package/dist/api/partner-v2-api.js +269 -1439
  16. package/dist/api/well-known-api.d.ts +2 -2
  17. package/dist/api/well-known-api.js +2 -2
  18. package/dist/api.d.ts +2 -2
  19. package/dist/api.js +2 -2
  20. package/dist/base.d.ts +2 -2
  21. package/dist/base.js +2 -2
  22. package/dist/common.d.ts +2 -2
  23. package/dist/common.js +2 -2
  24. package/dist/configuration.d.ts +2 -2
  25. package/dist/configuration.js +2 -2
  26. package/dist/esm/api/oauth-api.d.ts +2 -2
  27. package/dist/esm/api/oauth-api.js +2 -2
  28. package/dist/esm/api/partner-v1-api.d.ts +2 -2
  29. package/dist/esm/api/partner-v1-api.js +2 -2
  30. package/dist/esm/api/partner-v2-api.d.ts +122 -678
  31. package/dist/esm/api/partner-v2-api.js +269 -1439
  32. package/dist/esm/api/well-known-api.d.ts +2 -2
  33. package/dist/esm/api/well-known-api.js +2 -2
  34. package/dist/esm/api.d.ts +2 -2
  35. package/dist/esm/api.js +2 -2
  36. package/dist/esm/base.d.ts +2 -2
  37. package/dist/esm/base.js +2 -2
  38. package/dist/esm/common.d.ts +2 -2
  39. package/dist/esm/common.js +2 -2
  40. package/dist/esm/configuration.d.ts +2 -2
  41. package/dist/esm/configuration.js +2 -2
  42. package/dist/esm/index.d.ts +2 -2
  43. package/dist/esm/index.js +2 -2
  44. package/dist/esm/models/acceptance-result-response-dto.d.ts +2 -2
  45. package/dist/esm/models/acceptance-result-response-dto.js +2 -2
  46. package/dist/esm/models/acceptance-result-v1-response-dto.d.ts +2 -2
  47. package/dist/esm/models/acceptance-result-v1-response-dto.js +2 -2
  48. package/dist/esm/models/acknowledge-products-v1-request-dto.d.ts +2 -2
  49. package/dist/esm/models/acknowledge-products-v1-request-dto.js +2 -2
  50. package/dist/esm/models/api-catalog-dto.d.ts +2 -2
  51. package/dist/esm/models/api-catalog-dto.js +2 -2
  52. package/dist/esm/models/api-catalog-entry-dto.d.ts +2 -2
  53. package/dist/esm/models/api-catalog-entry-dto.js +2 -2
  54. package/dist/esm/models/api-catalog-link-dto.d.ts +2 -2
  55. package/dist/esm/models/api-catalog-link-dto.js +2 -2
  56. package/dist/esm/models/authorization-server-metadata-dto.d.ts +2 -2
  57. package/dist/esm/models/authorization-server-metadata-dto.js +2 -2
  58. package/dist/esm/models/award-method-public.d.ts +2 -2
  59. package/dist/esm/models/award-method-public.js +2 -2
  60. package/dist/esm/models/award-registered-response-dto.d.ts +2 -2
  61. package/dist/esm/models/award-registered-response-dto.js +2 -2
  62. package/dist/esm/models/award-registered-v2-response-dto.d.ts +2 -2
  63. package/dist/esm/models/award-registered-v2-response-dto.js +2 -2
  64. package/dist/esm/models/award-reverted-v2-response-dto.d.ts +2 -2
  65. package/dist/esm/models/award-reverted-v2-response-dto.js +2 -2
  66. package/dist/esm/models/bid-acceptance-dto.d.ts +2 -2
  67. package/dist/esm/models/bid-acceptance-dto.js +2 -2
  68. package/dist/esm/models/bid-attachment-v1-dto.d.ts +2 -2
  69. package/dist/esm/models/bid-attachment-v1-dto.js +2 -2
  70. package/dist/esm/models/bid-bond-dto.d.ts +2 -2
  71. package/dist/esm/models/bid-bond-dto.js +2 -2
  72. package/dist/esm/models/bid-bond-v1-dto.d.ts +2 -2
  73. package/dist/esm/models/bid-bond-v1-dto.js +2 -2
  74. package/dist/esm/models/bid-cancelled-response-dto.d.ts +2 -2
  75. package/dist/esm/models/bid-cancelled-response-dto.js +2 -2
  76. package/dist/esm/models/bid-contact-dto.d.ts +2 -2
  77. package/dist/esm/models/bid-contact-dto.js +2 -2
  78. package/dist/esm/models/bid-contacts-dto.d.ts +2 -2
  79. package/dist/esm/models/bid-contacts-dto.js +2 -2
  80. package/dist/esm/models/bid-contract-document-dto.d.ts +2 -2
  81. package/dist/esm/models/bid-contract-document-dto.js +2 -2
  82. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.d.ts +2 -2
  83. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.js +2 -2
  84. package/dist/esm/models/bid-contract-documents-v1-response-dto.d.ts +2 -2
  85. package/dist/esm/models/bid-contract-documents-v1-response-dto.js +2 -2
  86. package/dist/esm/models/bid-created-response-dto.d.ts +2 -2
  87. package/dist/esm/models/bid-created-response-dto.js +2 -2
  88. package/dist/esm/models/bid-delivery-terms-dto.d.ts +2 -2
  89. package/dist/esm/models/bid-delivery-terms-dto.js +2 -2
  90. package/dist/esm/models/bid-detail-response-dto.d.ts +2 -2
  91. package/dist/esm/models/bid-detail-response-dto.js +2 -2
  92. package/dist/esm/models/bid-document-dto.d.ts +2 -2
  93. package/dist/esm/models/bid-document-dto.js +2 -2
  94. package/dist/esm/models/bid-document-v1-dto.d.ts +2 -2
  95. package/dist/esm/models/bid-document-v1-dto.js +2 -2
  96. package/dist/esm/models/bid-failed-response-dto.d.ts +2 -2
  97. package/dist/esm/models/bid-failed-response-dto.js +2 -2
  98. package/dist/esm/models/bid-failed-v2-response-dto.d.ts +2 -2
  99. package/dist/esm/models/bid-failed-v2-response-dto.js +2 -2
  100. package/dist/esm/models/bid-failure-reason.d.ts +2 -2
  101. package/dist/esm/models/bid-failure-reason.js +2 -2
  102. package/dist/esm/models/bid-item-dto.d.ts +2 -2
  103. package/dist/esm/models/bid-item-dto.js +2 -2
  104. package/dist/esm/models/bid-item-v1-dto.d.ts +2 -2
  105. package/dist/esm/models/bid-item-v1-dto.js +2 -2
  106. package/dist/esm/models/bid-lifecycle-dto.d.ts +2 -2
  107. package/dist/esm/models/bid-lifecycle-dto.js +2 -2
  108. package/dist/esm/models/bid-manager-dto.d.ts +2 -2
  109. package/dist/esm/models/bid-manager-dto.js +2 -2
  110. package/dist/esm/models/bid-manager-v1-dto.d.ts +2 -2
  111. package/dist/esm/models/bid-manager-v1-dto.js +2 -2
  112. package/dist/esm/models/bid-payment-terms-dto.d.ts +2 -2
  113. package/dist/esm/models/bid-payment-terms-dto.js +2 -2
  114. package/dist/esm/models/bid-product-dto.d.ts +2 -2
  115. package/dist/esm/models/bid-product-dto.js +2 -2
  116. package/dist/esm/models/bid-public-status.d.ts +2 -2
  117. package/dist/esm/models/bid-public-status.js +2 -2
  118. package/dist/esm/models/bid-registered-response-dto.d.ts +2 -2
  119. package/dist/esm/models/bid-registered-response-dto.js +2 -2
  120. package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +2 -2
  121. package/dist/esm/models/bid-result-participant-attachment-dto.js +2 -2
  122. package/dist/esm/models/bid-result-participant-dto.d.ts +2 -2
  123. package/dist/esm/models/bid-result-participant-dto.js +2 -2
  124. package/dist/esm/models/bid-result-v1-attachment-dto.d.ts +2 -2
  125. package/dist/esm/models/bid-result-v1-attachment-dto.js +2 -2
  126. package/dist/esm/models/bid-result-v1-bid-product-info-dto.d.ts +2 -2
  127. package/dist/esm/models/bid-result-v1-bid-product-info-dto.js +2 -2
  128. package/dist/esm/models/bid-result-v1-participant-dto.d.ts +2 -2
  129. package/dist/esm/models/bid-result-v1-participant-dto.js +2 -2
  130. package/dist/esm/models/bid-result-v1-product-dto.d.ts +2 -2
  131. package/dist/esm/models/bid-result-v1-product-dto.js +2 -2
  132. package/dist/esm/models/bid-results-batch-v1-request-dto.d.ts +2 -2
  133. package/dist/esm/models/bid-results-batch-v1-request-dto.js +2 -2
  134. package/dist/esm/models/bid-results-response-dto.d.ts +2 -2
  135. package/dist/esm/models/bid-results-response-dto.js +2 -2
  136. package/dist/esm/models/bid-results-v1-response-dto.d.ts +2 -2
  137. package/dist/esm/models/bid-results-v1-response-dto.js +2 -2
  138. package/dist/esm/models/bid-settlement-line-item-dto.d.ts +2 -2
  139. package/dist/esm/models/bid-settlement-line-item-dto.js +2 -2
  140. package/dist/esm/models/bid-settlement-participant-dto.d.ts +2 -2
  141. package/dist/esm/models/bid-settlement-participant-dto.js +2 -2
  142. package/dist/esm/models/bid-settlement-response-dto.d.ts +2 -2
  143. package/dist/esm/models/bid-settlement-response-dto.js +2 -2
  144. package/dist/esm/models/bid-statement-response-dto.d.ts +2 -2
  145. package/dist/esm/models/bid-statement-response-dto.js +2 -2
  146. package/dist/esm/models/bid-statement-v1-response-dto.d.ts +2 -2
  147. package/dist/esm/models/bid-statement-v1-response-dto.js +2 -2
  148. package/dist/esm/models/bid-status.d.ts +2 -2
  149. package/dist/esm/models/bid-status.js +2 -2
  150. package/dist/esm/models/bid-summary-dto.d.ts +2 -2
  151. package/dist/esm/models/bid-summary-dto.js +2 -2
  152. package/dist/esm/models/bid-updated-response-dto.d.ts +2 -2
  153. package/dist/esm/models/bid-updated-response-dto.js +2 -2
  154. package/dist/esm/models/cancel-bid-request-dto.d.ts +2 -2
  155. package/dist/esm/models/cancel-bid-request-dto.js +2 -2
  156. package/dist/esm/models/cancel-bid200-response.d.ts +2 -2
  157. package/dist/esm/models/cancel-bid200-response.js +2 -2
  158. package/dist/esm/models/card-payment-request-response-dto.d.ts +2 -2
  159. package/dist/esm/models/card-payment-request-response-dto.js +2 -2
  160. package/dist/esm/models/complete-acceptance-request-dto.d.ts +2 -2
  161. package/dist/esm/models/complete-acceptance-request-dto.js +2 -2
  162. package/dist/esm/models/complete-acceptance-v1-request-dto.d.ts +2 -2
  163. package/dist/esm/models/complete-acceptance-v1-request-dto.js +2 -2
  164. package/dist/esm/models/complete-acceptance200-response.d.ts +2 -2
  165. package/dist/esm/models/complete-acceptance200-response.js +2 -2
  166. package/dist/esm/models/complete-invoice200-response.d.ts +2 -2
  167. package/dist/esm/models/complete-invoice200-response.js +2 -2
  168. package/dist/esm/models/contract-document-item-dto.d.ts +2 -2
  169. package/dist/esm/models/contract-document-item-dto.js +2 -2
  170. package/dist/esm/models/contract-restriction-confirm-input-dto.d.ts +2 -2
  171. package/dist/esm/models/contract-restriction-confirm-input-dto.js +2 -2
  172. package/dist/esm/models/create-bid-request-dto.d.ts +2 -2
  173. package/dist/esm/models/create-bid-request-dto.js +2 -2
  174. package/dist/esm/models/create-bid-v1-request-dto.d.ts +2 -2
  175. package/dist/esm/models/create-bid-v1-request-dto.js +2 -2
  176. package/dist/esm/models/create-card-payment-request-dto.d.ts +2 -2
  177. package/dist/esm/models/create-card-payment-request-dto.js +2 -2
  178. package/dist/esm/models/create-external-contract-documents-request-dto.d.ts +2 -2
  179. package/dist/esm/models/create-external-contract-documents-request-dto.js +2 -2
  180. package/dist/esm/models/create-external-contract-documents-response-dto.d.ts +2 -2
  181. package/dist/esm/models/create-external-contract-documents-response-dto.js +2 -2
  182. package/dist/esm/models/external-contract-document-item-dto.d.ts +2 -2
  183. package/dist/esm/models/external-contract-document-item-dto.js +2 -2
  184. package/dist/esm/models/external-contract-documents-response-dto.d.ts +2 -2
  185. package/dist/esm/models/external-contract-documents-response-dto.js +2 -2
  186. package/dist/esm/models/external-contract-item-dto.d.ts +2 -2
  187. package/dist/esm/models/external-contract-item-dto.js +2 -2
  188. package/dist/esm/models/external-contract-snapshot-dto.d.ts +2 -2
  189. package/dist/esm/models/external-contract-snapshot-dto.js +2 -2
  190. package/dist/esm/models/external-document-inputs-dto.d.ts +2 -2
  191. package/dist/esm/models/external-document-inputs-dto.js +2 -2
  192. package/dist/esm/models/file-meta-response-dto.d.ts +2 -2
  193. package/dist/esm/models/file-meta-response-dto.js +2 -2
  194. package/dist/esm/models/file-uploaded-response-dto.d.ts +2 -2
  195. package/dist/esm/models/file-uploaded-response-dto.js +2 -2
  196. package/dist/esm/models/file-uploaded-v1-response-dto.d.ts +2 -2
  197. package/dist/esm/models/file-uploaded-v1-response-dto.js +2 -2
  198. package/dist/esm/models/generated-external-contract-document-dto.d.ts +2 -2
  199. package/dist/esm/models/generated-external-contract-document-dto.js +2 -2
  200. package/dist/esm/models/get-bid-settlement200-response.d.ts +2 -2
  201. package/dist/esm/models/get-bid-settlement200-response.js +2 -2
  202. package/dist/esm/models/get-bid-statement200-response.d.ts +2 -2
  203. package/dist/esm/models/get-bid-statement200-response.js +2 -2
  204. package/dist/esm/models/get-bid200-response.d.ts +2 -2
  205. package/dist/esm/models/get-bid200-response.js +2 -2
  206. package/dist/esm/models/get-file-meta200-response.d.ts +2 -2
  207. package/dist/esm/models/get-file-meta200-response.js +2 -2
  208. package/dist/esm/models/health-controller-check200-response.d.ts +2 -2
  209. package/dist/esm/models/health-controller-check200-response.js +2 -2
  210. package/dist/esm/models/health-response-dto.d.ts +2 -2
  211. package/dist/esm/models/health-response-dto.js +2 -2
  212. package/dist/esm/models/hierarchical-region-dto.d.ts +2 -2
  213. package/dist/esm/models/hierarchical-region-dto.js +2 -2
  214. package/dist/esm/models/hierarchical-region-v1-dto.d.ts +2 -2
  215. package/dist/esm/models/hierarchical-region-v1-dto.js +2 -2
  216. package/dist/esm/models/index.d.ts +0 -36
  217. package/dist/esm/models/index.js +0 -36
  218. package/dist/esm/models/introspect-request-dto.d.ts +2 -2
  219. package/dist/esm/models/introspect-request-dto.js +2 -2
  220. package/dist/esm/models/introspection-response-dto.d.ts +2 -2
  221. package/dist/esm/models/introspection-response-dto.js +2 -2
  222. package/dist/esm/models/invalid-param-dto.d.ts +2 -2
  223. package/dist/esm/models/invalid-param-dto.js +2 -2
  224. package/dist/esm/models/invoice-completed-response-dto.d.ts +2 -2
  225. package/dist/esm/models/invoice-completed-response-dto.js +2 -2
  226. package/dist/esm/models/list-bid-results200-response.d.ts +2 -2
  227. package/dist/esm/models/list-bid-results200-response.js +2 -2
  228. package/dist/esm/models/list-bids-response-dto.d.ts +2 -2
  229. package/dist/esm/models/list-bids-response-dto.js +2 -2
  230. package/dist/esm/models/list-bids200-response.d.ts +2 -2
  231. package/dist/esm/models/list-bids200-response.js +2 -2
  232. package/dist/esm/models/mark-bid-failed-request-dto.d.ts +2 -2
  233. package/dist/esm/models/mark-bid-failed-request-dto.js +2 -2
  234. package/dist/esm/models/mark-bid-failed-v1-request-dto.d.ts +2 -2
  235. package/dist/esm/models/mark-bid-failed-v1-request-dto.js +2 -2
  236. package/dist/esm/models/mark-bid-failed201-response.d.ts +2 -2
  237. package/dist/esm/models/mark-bid-failed201-response.js +2 -2
  238. package/dist/esm/models/negotiation-score-v1-dto.d.ts +2 -2
  239. package/dist/esm/models/negotiation-score-v1-dto.js +2 -2
  240. package/dist/esm/models/negotiation-scored-response-dto.d.ts +2 -2
  241. package/dist/esm/models/negotiation-scored-response-dto.js +2 -2
  242. package/dist/esm/models/oauth-error-response-dto.d.ts +2 -2
  243. package/dist/esm/models/oauth-error-response-dto.js +2 -2
  244. package/dist/esm/models/preconditions-dto.d.ts +2 -2
  245. package/dist/esm/models/preconditions-dto.js +2 -2
  246. package/dist/esm/models/preconditions-v1-dto.d.ts +2 -2
  247. package/dist/esm/models/preconditions-v1-dto.js +2 -2
  248. package/dist/esm/models/problem-details-dto.d.ts +2 -2
  249. package/dist/esm/models/problem-details-dto.js +2 -2
  250. package/dist/esm/models/product-receipt-v1-response-dto.d.ts +2 -2
  251. package/dist/esm/models/product-receipt-v1-response-dto.js +2 -2
  252. package/dist/esm/models/product-v1-response-dto.d.ts +2 -2
  253. package/dist/esm/models/product-v1-response-dto.js +2 -2
  254. package/dist/esm/models/protected-resource-metadata-dto.d.ts +2 -2
  255. package/dist/esm/models/protected-resource-metadata-dto.js +2 -2
  256. package/dist/esm/models/register-award-request-dto.d.ts +2 -2
  257. package/dist/esm/models/register-award-request-dto.js +2 -2
  258. package/dist/esm/models/register-award-v1-request-dto.d.ts +2 -2
  259. package/dist/esm/models/register-award-v1-request-dto.js +2 -2
  260. package/dist/esm/models/register-award201-response.d.ts +2 -2
  261. package/dist/esm/models/register-award201-response.js +2 -2
  262. package/dist/esm/models/register-bid201-response.d.ts +2 -2
  263. package/dist/esm/models/register-bid201-response.js +2 -2
  264. package/dist/esm/models/register-semo-contract-request-dto.d.ts +2 -2
  265. package/dist/esm/models/register-semo-contract-request-dto.js +2 -2
  266. package/dist/esm/models/request-split-invoice-v1-request-dto.d.ts +2 -2
  267. package/dist/esm/models/request-split-invoice-v1-request-dto.js +2 -2
  268. package/dist/esm/models/retiree-roster-input-dto.d.ts +2 -2
  269. package/dist/esm/models/retiree-roster-input-dto.js +2 -2
  270. package/dist/esm/models/retiree-roster-row-dto.d.ts +2 -2
  271. package/dist/esm/models/retiree-roster-row-dto.js +2 -2
  272. package/dist/esm/models/revert-award-request-dto.d.ts +2 -2
  273. package/dist/esm/models/revert-award-request-dto.js +2 -2
  274. package/dist/esm/models/revert-award200-response.d.ts +2 -2
  275. package/dist/esm/models/revert-award200-response.js +2 -2
  276. package/dist/esm/models/revoke-request-dto.d.ts +2 -2
  277. package/dist/esm/models/revoke-request-dto.js +2 -2
  278. package/dist/esm/models/semo-contract-registered-response-dto.d.ts +2 -2
  279. package/dist/esm/models/semo-contract-registered-response-dto.js +2 -2
  280. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
  281. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
  282. package/dist/esm/models/split-invoice-v1-response-dto.d.ts +2 -2
  283. package/dist/esm/models/split-invoice-v1-response-dto.js +2 -2
  284. package/dist/esm/models/statement-document-dto.d.ts +2 -2
  285. package/dist/esm/models/statement-document-dto.js +2 -2
  286. package/dist/esm/models/statement-product-dto.d.ts +2 -2
  287. package/dist/esm/models/statement-product-dto.js +2 -2
  288. package/dist/esm/models/statement-v1-document-dto.d.ts +2 -2
  289. package/dist/esm/models/statement-v1-document-dto.js +2 -2
  290. package/dist/esm/models/statement-v1-product-dto.d.ts +2 -2
  291. package/dist/esm/models/statement-v1-product-dto.js +2 -2
  292. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.d.ts +2 -2
  293. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.js +2 -2
  294. package/dist/esm/models/supplier-card-payable-response-dto.d.ts +2 -2
  295. package/dist/esm/models/supplier-card-payable-response-dto.js +2 -2
  296. package/dist/esm/models/supplier-tax-type.d.ts +2 -2
  297. package/dist/esm/models/supplier-tax-type.js +2 -2
  298. package/dist/esm/models/token-request-dto.d.ts +2 -2
  299. package/dist/esm/models/token-request-dto.js +2 -2
  300. package/dist/esm/models/token-response-dto.d.ts +2 -2
  301. package/dist/esm/models/token-response-dto.js +2 -2
  302. package/dist/esm/models/update-bid-request-dto.d.ts +2 -2
  303. package/dist/esm/models/update-bid-request-dto.js +2 -2
  304. package/dist/esm/models/update-bid200-response.d.ts +2 -2
  305. package/dist/esm/models/update-bid200-response.js +2 -2
  306. package/dist/esm/models/upload-file-request-dto.d.ts +2 -2
  307. package/dist/esm/models/upload-file-request-dto.js +2 -2
  308. package/dist/esm/models/upload-file-v1-request-dto.d.ts +2 -2
  309. package/dist/esm/models/upload-file-v1-request-dto.js +2 -2
  310. package/dist/esm/models/upload-file201-response.d.ts +2 -2
  311. package/dist/esm/models/upload-file201-response.js +2 -2
  312. package/dist/index.d.ts +2 -2
  313. package/dist/index.js +2 -2
  314. package/dist/models/acceptance-result-response-dto.d.ts +2 -2
  315. package/dist/models/acceptance-result-response-dto.js +2 -2
  316. package/dist/models/acceptance-result-v1-response-dto.d.ts +2 -2
  317. package/dist/models/acceptance-result-v1-response-dto.js +2 -2
  318. package/dist/models/acknowledge-products-v1-request-dto.d.ts +2 -2
  319. package/dist/models/acknowledge-products-v1-request-dto.js +2 -2
  320. package/dist/models/api-catalog-dto.d.ts +2 -2
  321. package/dist/models/api-catalog-dto.js +2 -2
  322. package/dist/models/api-catalog-entry-dto.d.ts +2 -2
  323. package/dist/models/api-catalog-entry-dto.js +2 -2
  324. package/dist/models/api-catalog-link-dto.d.ts +2 -2
  325. package/dist/models/api-catalog-link-dto.js +2 -2
  326. package/dist/models/authorization-server-metadata-dto.d.ts +2 -2
  327. package/dist/models/authorization-server-metadata-dto.js +2 -2
  328. package/dist/models/award-method-public.d.ts +2 -2
  329. package/dist/models/award-method-public.js +2 -2
  330. package/dist/models/award-registered-response-dto.d.ts +2 -2
  331. package/dist/models/award-registered-response-dto.js +2 -2
  332. package/dist/models/award-registered-v2-response-dto.d.ts +2 -2
  333. package/dist/models/award-registered-v2-response-dto.js +2 -2
  334. package/dist/models/award-reverted-v2-response-dto.d.ts +2 -2
  335. package/dist/models/award-reverted-v2-response-dto.js +2 -2
  336. package/dist/models/bid-acceptance-dto.d.ts +2 -2
  337. package/dist/models/bid-acceptance-dto.js +2 -2
  338. package/dist/models/bid-attachment-v1-dto.d.ts +2 -2
  339. package/dist/models/bid-attachment-v1-dto.js +2 -2
  340. package/dist/models/bid-bond-dto.d.ts +2 -2
  341. package/dist/models/bid-bond-dto.js +2 -2
  342. package/dist/models/bid-bond-v1-dto.d.ts +2 -2
  343. package/dist/models/bid-bond-v1-dto.js +2 -2
  344. package/dist/models/bid-cancelled-response-dto.d.ts +2 -2
  345. package/dist/models/bid-cancelled-response-dto.js +2 -2
  346. package/dist/models/bid-contact-dto.d.ts +2 -2
  347. package/dist/models/bid-contact-dto.js +2 -2
  348. package/dist/models/bid-contacts-dto.d.ts +2 -2
  349. package/dist/models/bid-contacts-dto.js +2 -2
  350. package/dist/models/bid-contract-document-dto.d.ts +2 -2
  351. package/dist/models/bid-contract-document-dto.js +2 -2
  352. package/dist/models/bid-contract-documents-batch-v1-request-dto.d.ts +2 -2
  353. package/dist/models/bid-contract-documents-batch-v1-request-dto.js +2 -2
  354. package/dist/models/bid-contract-documents-v1-response-dto.d.ts +2 -2
  355. package/dist/models/bid-contract-documents-v1-response-dto.js +2 -2
  356. package/dist/models/bid-created-response-dto.d.ts +2 -2
  357. package/dist/models/bid-created-response-dto.js +2 -2
  358. package/dist/models/bid-delivery-terms-dto.d.ts +2 -2
  359. package/dist/models/bid-delivery-terms-dto.js +2 -2
  360. package/dist/models/bid-detail-response-dto.d.ts +2 -2
  361. package/dist/models/bid-detail-response-dto.js +2 -2
  362. package/dist/models/bid-document-dto.d.ts +2 -2
  363. package/dist/models/bid-document-dto.js +2 -2
  364. package/dist/models/bid-document-v1-dto.d.ts +2 -2
  365. package/dist/models/bid-document-v1-dto.js +2 -2
  366. package/dist/models/bid-failed-response-dto.d.ts +2 -2
  367. package/dist/models/bid-failed-response-dto.js +2 -2
  368. package/dist/models/bid-failed-v2-response-dto.d.ts +2 -2
  369. package/dist/models/bid-failed-v2-response-dto.js +2 -2
  370. package/dist/models/bid-failure-reason.d.ts +2 -2
  371. package/dist/models/bid-failure-reason.js +2 -2
  372. package/dist/models/bid-item-dto.d.ts +2 -2
  373. package/dist/models/bid-item-dto.js +2 -2
  374. package/dist/models/bid-item-v1-dto.d.ts +2 -2
  375. package/dist/models/bid-item-v1-dto.js +2 -2
  376. package/dist/models/bid-lifecycle-dto.d.ts +2 -2
  377. package/dist/models/bid-lifecycle-dto.js +2 -2
  378. package/dist/models/bid-manager-dto.d.ts +2 -2
  379. package/dist/models/bid-manager-dto.js +2 -2
  380. package/dist/models/bid-manager-v1-dto.d.ts +2 -2
  381. package/dist/models/bid-manager-v1-dto.js +2 -2
  382. package/dist/models/bid-payment-terms-dto.d.ts +2 -2
  383. package/dist/models/bid-payment-terms-dto.js +2 -2
  384. package/dist/models/bid-product-dto.d.ts +2 -2
  385. package/dist/models/bid-product-dto.js +2 -2
  386. package/dist/models/bid-public-status.d.ts +2 -2
  387. package/dist/models/bid-public-status.js +2 -2
  388. package/dist/models/bid-registered-response-dto.d.ts +2 -2
  389. package/dist/models/bid-registered-response-dto.js +2 -2
  390. package/dist/models/bid-result-participant-attachment-dto.d.ts +2 -2
  391. package/dist/models/bid-result-participant-attachment-dto.js +2 -2
  392. package/dist/models/bid-result-participant-dto.d.ts +2 -2
  393. package/dist/models/bid-result-participant-dto.js +2 -2
  394. package/dist/models/bid-result-v1-attachment-dto.d.ts +2 -2
  395. package/dist/models/bid-result-v1-attachment-dto.js +2 -2
  396. package/dist/models/bid-result-v1-bid-product-info-dto.d.ts +2 -2
  397. package/dist/models/bid-result-v1-bid-product-info-dto.js +2 -2
  398. package/dist/models/bid-result-v1-participant-dto.d.ts +2 -2
  399. package/dist/models/bid-result-v1-participant-dto.js +2 -2
  400. package/dist/models/bid-result-v1-product-dto.d.ts +2 -2
  401. package/dist/models/bid-result-v1-product-dto.js +2 -2
  402. package/dist/models/bid-results-batch-v1-request-dto.d.ts +2 -2
  403. package/dist/models/bid-results-batch-v1-request-dto.js +2 -2
  404. package/dist/models/bid-results-response-dto.d.ts +2 -2
  405. package/dist/models/bid-results-response-dto.js +2 -2
  406. package/dist/models/bid-results-v1-response-dto.d.ts +2 -2
  407. package/dist/models/bid-results-v1-response-dto.js +2 -2
  408. package/dist/models/bid-settlement-line-item-dto.d.ts +2 -2
  409. package/dist/models/bid-settlement-line-item-dto.js +2 -2
  410. package/dist/models/bid-settlement-participant-dto.d.ts +2 -2
  411. package/dist/models/bid-settlement-participant-dto.js +2 -2
  412. package/dist/models/bid-settlement-response-dto.d.ts +2 -2
  413. package/dist/models/bid-settlement-response-dto.js +2 -2
  414. package/dist/models/bid-statement-response-dto.d.ts +2 -2
  415. package/dist/models/bid-statement-response-dto.js +2 -2
  416. package/dist/models/bid-statement-v1-response-dto.d.ts +2 -2
  417. package/dist/models/bid-statement-v1-response-dto.js +2 -2
  418. package/dist/models/bid-status.d.ts +2 -2
  419. package/dist/models/bid-status.js +2 -2
  420. package/dist/models/bid-summary-dto.d.ts +2 -2
  421. package/dist/models/bid-summary-dto.js +2 -2
  422. package/dist/models/bid-updated-response-dto.d.ts +2 -2
  423. package/dist/models/bid-updated-response-dto.js +2 -2
  424. package/dist/models/cancel-bid-request-dto.d.ts +2 -2
  425. package/dist/models/cancel-bid-request-dto.js +2 -2
  426. package/dist/models/cancel-bid200-response.d.ts +2 -2
  427. package/dist/models/cancel-bid200-response.js +2 -2
  428. package/dist/models/card-payment-request-response-dto.d.ts +2 -2
  429. package/dist/models/card-payment-request-response-dto.js +2 -2
  430. package/dist/models/complete-acceptance-request-dto.d.ts +2 -2
  431. package/dist/models/complete-acceptance-request-dto.js +2 -2
  432. package/dist/models/complete-acceptance-v1-request-dto.d.ts +2 -2
  433. package/dist/models/complete-acceptance-v1-request-dto.js +2 -2
  434. package/dist/models/complete-acceptance200-response.d.ts +2 -2
  435. package/dist/models/complete-acceptance200-response.js +2 -2
  436. package/dist/models/complete-invoice200-response.d.ts +2 -2
  437. package/dist/models/complete-invoice200-response.js +2 -2
  438. package/dist/models/contract-document-item-dto.d.ts +2 -2
  439. package/dist/models/contract-document-item-dto.js +2 -2
  440. package/dist/models/contract-restriction-confirm-input-dto.d.ts +2 -2
  441. package/dist/models/contract-restriction-confirm-input-dto.js +2 -2
  442. package/dist/models/create-bid-request-dto.d.ts +2 -2
  443. package/dist/models/create-bid-request-dto.js +2 -2
  444. package/dist/models/create-bid-v1-request-dto.d.ts +2 -2
  445. package/dist/models/create-bid-v1-request-dto.js +2 -2
  446. package/dist/models/create-card-payment-request-dto.d.ts +2 -2
  447. package/dist/models/create-card-payment-request-dto.js +2 -2
  448. package/dist/models/create-external-contract-documents-request-dto.d.ts +2 -2
  449. package/dist/models/create-external-contract-documents-request-dto.js +2 -2
  450. package/dist/models/create-external-contract-documents-response-dto.d.ts +2 -2
  451. package/dist/models/create-external-contract-documents-response-dto.js +2 -2
  452. package/dist/models/external-contract-document-item-dto.d.ts +2 -2
  453. package/dist/models/external-contract-document-item-dto.js +2 -2
  454. package/dist/models/external-contract-documents-response-dto.d.ts +2 -2
  455. package/dist/models/external-contract-documents-response-dto.js +2 -2
  456. package/dist/models/external-contract-item-dto.d.ts +2 -2
  457. package/dist/models/external-contract-item-dto.js +2 -2
  458. package/dist/models/external-contract-snapshot-dto.d.ts +2 -2
  459. package/dist/models/external-contract-snapshot-dto.js +2 -2
  460. package/dist/models/external-document-inputs-dto.d.ts +2 -2
  461. package/dist/models/external-document-inputs-dto.js +2 -2
  462. package/dist/models/file-meta-response-dto.d.ts +2 -2
  463. package/dist/models/file-meta-response-dto.js +2 -2
  464. package/dist/models/file-uploaded-response-dto.d.ts +2 -2
  465. package/dist/models/file-uploaded-response-dto.js +2 -2
  466. package/dist/models/file-uploaded-v1-response-dto.d.ts +2 -2
  467. package/dist/models/file-uploaded-v1-response-dto.js +2 -2
  468. package/dist/models/generated-external-contract-document-dto.d.ts +2 -2
  469. package/dist/models/generated-external-contract-document-dto.js +2 -2
  470. package/dist/models/get-bid-settlement200-response.d.ts +2 -2
  471. package/dist/models/get-bid-settlement200-response.js +2 -2
  472. package/dist/models/get-bid-statement200-response.d.ts +2 -2
  473. package/dist/models/get-bid-statement200-response.js +2 -2
  474. package/dist/models/get-bid200-response.d.ts +2 -2
  475. package/dist/models/get-bid200-response.js +2 -2
  476. package/dist/models/get-file-meta200-response.d.ts +2 -2
  477. package/dist/models/get-file-meta200-response.js +2 -2
  478. package/dist/models/health-controller-check200-response.d.ts +2 -2
  479. package/dist/models/health-controller-check200-response.js +2 -2
  480. package/dist/models/health-response-dto.d.ts +2 -2
  481. package/dist/models/health-response-dto.js +2 -2
  482. package/dist/models/hierarchical-region-dto.d.ts +2 -2
  483. package/dist/models/hierarchical-region-dto.js +2 -2
  484. package/dist/models/hierarchical-region-v1-dto.d.ts +2 -2
  485. package/dist/models/hierarchical-region-v1-dto.js +2 -2
  486. package/dist/models/index.d.ts +0 -36
  487. package/dist/models/index.js +0 -36
  488. package/dist/models/introspect-request-dto.d.ts +2 -2
  489. package/dist/models/introspect-request-dto.js +2 -2
  490. package/dist/models/introspection-response-dto.d.ts +2 -2
  491. package/dist/models/introspection-response-dto.js +2 -2
  492. package/dist/models/invalid-param-dto.d.ts +2 -2
  493. package/dist/models/invalid-param-dto.js +2 -2
  494. package/dist/models/invoice-completed-response-dto.d.ts +2 -2
  495. package/dist/models/invoice-completed-response-dto.js +2 -2
  496. package/dist/models/list-bid-results200-response.d.ts +2 -2
  497. package/dist/models/list-bid-results200-response.js +2 -2
  498. package/dist/models/list-bids-response-dto.d.ts +2 -2
  499. package/dist/models/list-bids-response-dto.js +2 -2
  500. package/dist/models/list-bids200-response.d.ts +2 -2
  501. package/dist/models/list-bids200-response.js +2 -2
  502. package/dist/models/mark-bid-failed-request-dto.d.ts +2 -2
  503. package/dist/models/mark-bid-failed-request-dto.js +2 -2
  504. package/dist/models/mark-bid-failed-v1-request-dto.d.ts +2 -2
  505. package/dist/models/mark-bid-failed-v1-request-dto.js +2 -2
  506. package/dist/models/mark-bid-failed201-response.d.ts +2 -2
  507. package/dist/models/mark-bid-failed201-response.js +2 -2
  508. package/dist/models/negotiation-score-v1-dto.d.ts +2 -2
  509. package/dist/models/negotiation-score-v1-dto.js +2 -2
  510. package/dist/models/negotiation-scored-response-dto.d.ts +2 -2
  511. package/dist/models/negotiation-scored-response-dto.js +2 -2
  512. package/dist/models/oauth-error-response-dto.d.ts +2 -2
  513. package/dist/models/oauth-error-response-dto.js +2 -2
  514. package/dist/models/preconditions-dto.d.ts +2 -2
  515. package/dist/models/preconditions-dto.js +2 -2
  516. package/dist/models/preconditions-v1-dto.d.ts +2 -2
  517. package/dist/models/preconditions-v1-dto.js +2 -2
  518. package/dist/models/problem-details-dto.d.ts +2 -2
  519. package/dist/models/problem-details-dto.js +2 -2
  520. package/dist/models/product-receipt-v1-response-dto.d.ts +2 -2
  521. package/dist/models/product-receipt-v1-response-dto.js +2 -2
  522. package/dist/models/product-v1-response-dto.d.ts +2 -2
  523. package/dist/models/product-v1-response-dto.js +2 -2
  524. package/dist/models/protected-resource-metadata-dto.d.ts +2 -2
  525. package/dist/models/protected-resource-metadata-dto.js +2 -2
  526. package/dist/models/register-award-request-dto.d.ts +2 -2
  527. package/dist/models/register-award-request-dto.js +2 -2
  528. package/dist/models/register-award-v1-request-dto.d.ts +2 -2
  529. package/dist/models/register-award-v1-request-dto.js +2 -2
  530. package/dist/models/register-award201-response.d.ts +2 -2
  531. package/dist/models/register-award201-response.js +2 -2
  532. package/dist/models/register-bid201-response.d.ts +2 -2
  533. package/dist/models/register-bid201-response.js +2 -2
  534. package/dist/models/register-semo-contract-request-dto.d.ts +2 -2
  535. package/dist/models/register-semo-contract-request-dto.js +2 -2
  536. package/dist/models/request-split-invoice-v1-request-dto.d.ts +2 -2
  537. package/dist/models/request-split-invoice-v1-request-dto.js +2 -2
  538. package/dist/models/retiree-roster-input-dto.d.ts +2 -2
  539. package/dist/models/retiree-roster-input-dto.js +2 -2
  540. package/dist/models/retiree-roster-row-dto.d.ts +2 -2
  541. package/dist/models/retiree-roster-row-dto.js +2 -2
  542. package/dist/models/revert-award-request-dto.d.ts +2 -2
  543. package/dist/models/revert-award-request-dto.js +2 -2
  544. package/dist/models/revert-award200-response.d.ts +2 -2
  545. package/dist/models/revert-award200-response.js +2 -2
  546. package/dist/models/revoke-request-dto.d.ts +2 -2
  547. package/dist/models/revoke-request-dto.js +2 -2
  548. package/dist/models/semo-contract-registered-response-dto.d.ts +2 -2
  549. package/dist/models/semo-contract-registered-response-dto.js +2 -2
  550. package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
  551. package/dist/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
  552. package/dist/models/split-invoice-v1-response-dto.d.ts +2 -2
  553. package/dist/models/split-invoice-v1-response-dto.js +2 -2
  554. package/dist/models/statement-document-dto.d.ts +2 -2
  555. package/dist/models/statement-document-dto.js +2 -2
  556. package/dist/models/statement-product-dto.d.ts +2 -2
  557. package/dist/models/statement-product-dto.js +2 -2
  558. package/dist/models/statement-v1-document-dto.d.ts +2 -2
  559. package/dist/models/statement-v1-document-dto.js +2 -2
  560. package/dist/models/statement-v1-product-dto.d.ts +2 -2
  561. package/dist/models/statement-v1-product-dto.js +2 -2
  562. package/dist/models/submit-negotiation-scores-v1-request-dto.d.ts +2 -2
  563. package/dist/models/submit-negotiation-scores-v1-request-dto.js +2 -2
  564. package/dist/models/supplier-card-payable-response-dto.d.ts +2 -2
  565. package/dist/models/supplier-card-payable-response-dto.js +2 -2
  566. package/dist/models/supplier-tax-type.d.ts +2 -2
  567. package/dist/models/supplier-tax-type.js +2 -2
  568. package/dist/models/token-request-dto.d.ts +2 -2
  569. package/dist/models/token-request-dto.js +2 -2
  570. package/dist/models/token-response-dto.d.ts +2 -2
  571. package/dist/models/token-response-dto.js +2 -2
  572. package/dist/models/update-bid-request-dto.d.ts +2 -2
  573. package/dist/models/update-bid-request-dto.js +2 -2
  574. package/dist/models/update-bid200-response.d.ts +2 -2
  575. package/dist/models/update-bid200-response.js +2 -2
  576. package/dist/models/upload-file-request-dto.d.ts +2 -2
  577. package/dist/models/upload-file-request-dto.js +2 -2
  578. package/dist/models/upload-file-v1-request-dto.d.ts +2 -2
  579. package/dist/models/upload-file-v1-request-dto.js +2 -2
  580. package/dist/models/upload-file201-response.d.ts +2 -2
  581. package/dist/models/upload-file201-response.js +2 -2
  582. package/docs/PartnerV2Api.md +210 -1158
  583. package/index.ts +2 -2
  584. package/models/acceptance-result-response-dto.ts +2 -2
  585. package/models/acceptance-result-v1-response-dto.ts +2 -2
  586. package/models/acknowledge-products-v1-request-dto.ts +2 -2
  587. package/models/api-catalog-dto.ts +2 -2
  588. package/models/api-catalog-entry-dto.ts +2 -2
  589. package/models/api-catalog-link-dto.ts +2 -2
  590. package/models/authorization-server-metadata-dto.ts +2 -2
  591. package/models/award-method-public.ts +2 -2
  592. package/models/award-registered-response-dto.ts +2 -2
  593. package/models/award-registered-v2-response-dto.ts +2 -2
  594. package/models/award-reverted-v2-response-dto.ts +2 -2
  595. package/models/bid-acceptance-dto.ts +2 -2
  596. package/models/bid-attachment-v1-dto.ts +2 -2
  597. package/models/bid-bond-dto.ts +2 -2
  598. package/models/bid-bond-v1-dto.ts +2 -2
  599. package/models/bid-cancelled-response-dto.ts +2 -2
  600. package/models/bid-contact-dto.ts +2 -2
  601. package/models/bid-contacts-dto.ts +2 -2
  602. package/models/bid-contract-document-dto.ts +2 -2
  603. package/models/bid-contract-documents-batch-v1-request-dto.ts +2 -2
  604. package/models/bid-contract-documents-v1-response-dto.ts +2 -2
  605. package/models/bid-created-response-dto.ts +2 -2
  606. package/models/bid-delivery-terms-dto.ts +2 -2
  607. package/models/bid-detail-response-dto.ts +2 -2
  608. package/models/bid-document-dto.ts +2 -2
  609. package/models/bid-document-v1-dto.ts +2 -2
  610. package/models/bid-failed-response-dto.ts +2 -2
  611. package/models/bid-failed-v2-response-dto.ts +2 -2
  612. package/models/bid-failure-reason.ts +2 -2
  613. package/models/bid-item-dto.ts +2 -2
  614. package/models/bid-item-v1-dto.ts +2 -2
  615. package/models/bid-lifecycle-dto.ts +2 -2
  616. package/models/bid-manager-dto.ts +2 -2
  617. package/models/bid-manager-v1-dto.ts +2 -2
  618. package/models/bid-payment-terms-dto.ts +2 -2
  619. package/models/bid-product-dto.ts +2 -2
  620. package/models/bid-public-status.ts +2 -2
  621. package/models/bid-registered-response-dto.ts +2 -2
  622. package/models/bid-result-participant-attachment-dto.ts +2 -2
  623. package/models/bid-result-participant-dto.ts +2 -2
  624. package/models/bid-result-v1-attachment-dto.ts +2 -2
  625. package/models/bid-result-v1-bid-product-info-dto.ts +2 -2
  626. package/models/bid-result-v1-participant-dto.ts +2 -2
  627. package/models/bid-result-v1-product-dto.ts +2 -2
  628. package/models/bid-results-batch-v1-request-dto.ts +2 -2
  629. package/models/bid-results-response-dto.ts +2 -2
  630. package/models/bid-results-v1-response-dto.ts +2 -2
  631. package/models/bid-settlement-line-item-dto.ts +2 -2
  632. package/models/bid-settlement-participant-dto.ts +2 -2
  633. package/models/bid-settlement-response-dto.ts +2 -2
  634. package/models/bid-statement-response-dto.ts +2 -2
  635. package/models/bid-statement-v1-response-dto.ts +2 -2
  636. package/models/bid-status.ts +2 -2
  637. package/models/bid-summary-dto.ts +2 -2
  638. package/models/bid-updated-response-dto.ts +2 -2
  639. package/models/cancel-bid-request-dto.ts +2 -2
  640. package/models/cancel-bid200-response.ts +2 -2
  641. package/models/card-payment-request-response-dto.ts +2 -2
  642. package/models/complete-acceptance-request-dto.ts +2 -2
  643. package/models/complete-acceptance-v1-request-dto.ts +2 -2
  644. package/models/complete-acceptance200-response.ts +2 -2
  645. package/models/complete-invoice200-response.ts +2 -2
  646. package/models/contract-document-item-dto.ts +2 -2
  647. package/models/contract-restriction-confirm-input-dto.ts +2 -2
  648. package/models/create-bid-request-dto.ts +2 -2
  649. package/models/create-bid-v1-request-dto.ts +2 -2
  650. package/models/create-card-payment-request-dto.ts +2 -2
  651. package/models/create-external-contract-documents-request-dto.ts +2 -2
  652. package/models/create-external-contract-documents-response-dto.ts +2 -2
  653. package/models/external-contract-document-item-dto.ts +2 -2
  654. package/models/external-contract-documents-response-dto.ts +2 -2
  655. package/models/external-contract-item-dto.ts +2 -2
  656. package/models/external-contract-snapshot-dto.ts +2 -2
  657. package/models/external-document-inputs-dto.ts +2 -2
  658. package/models/file-meta-response-dto.ts +2 -2
  659. package/models/file-uploaded-response-dto.ts +2 -2
  660. package/models/file-uploaded-v1-response-dto.ts +2 -2
  661. package/models/generated-external-contract-document-dto.ts +2 -2
  662. package/models/get-bid-settlement200-response.ts +2 -2
  663. package/models/get-bid-statement200-response.ts +2 -2
  664. package/models/get-bid200-response.ts +2 -2
  665. package/models/get-file-meta200-response.ts +2 -2
  666. package/models/health-controller-check200-response.ts +2 -2
  667. package/models/health-response-dto.ts +2 -2
  668. package/models/hierarchical-region-dto.ts +2 -2
  669. package/models/hierarchical-region-v1-dto.ts +2 -2
  670. package/models/index.ts +0 -36
  671. package/models/introspect-request-dto.ts +2 -2
  672. package/models/introspection-response-dto.ts +2 -2
  673. package/models/invalid-param-dto.ts +2 -2
  674. package/models/invoice-completed-response-dto.ts +2 -2
  675. package/models/list-bid-results200-response.ts +2 -2
  676. package/models/list-bids-response-dto.ts +2 -2
  677. package/models/list-bids200-response.ts +2 -2
  678. package/models/mark-bid-failed-request-dto.ts +2 -2
  679. package/models/mark-bid-failed-v1-request-dto.ts +2 -2
  680. package/models/mark-bid-failed201-response.ts +2 -2
  681. package/models/negotiation-score-v1-dto.ts +2 -2
  682. package/models/negotiation-scored-response-dto.ts +2 -2
  683. package/models/oauth-error-response-dto.ts +2 -2
  684. package/models/preconditions-dto.ts +2 -2
  685. package/models/preconditions-v1-dto.ts +2 -2
  686. package/models/problem-details-dto.ts +2 -2
  687. package/models/product-receipt-v1-response-dto.ts +2 -2
  688. package/models/product-v1-response-dto.ts +2 -2
  689. package/models/protected-resource-metadata-dto.ts +2 -2
  690. package/models/register-award-request-dto.ts +2 -2
  691. package/models/register-award-v1-request-dto.ts +2 -2
  692. package/models/register-award201-response.ts +2 -2
  693. package/models/register-bid201-response.ts +2 -2
  694. package/models/register-semo-contract-request-dto.ts +2 -2
  695. package/models/request-split-invoice-v1-request-dto.ts +2 -2
  696. package/models/retiree-roster-input-dto.ts +2 -2
  697. package/models/retiree-roster-row-dto.ts +2 -2
  698. package/models/revert-award-request-dto.ts +2 -2
  699. package/models/revert-award200-response.ts +2 -2
  700. package/models/revoke-request-dto.ts +2 -2
  701. package/models/semo-contract-registered-response-dto.ts +2 -2
  702. package/models/semo-contract-taxinvoice-status-response-dto.ts +2 -2
  703. package/models/split-invoice-v1-response-dto.ts +2 -2
  704. package/models/statement-document-dto.ts +2 -2
  705. package/models/statement-product-dto.ts +2 -2
  706. package/models/statement-v1-document-dto.ts +2 -2
  707. package/models/statement-v1-product-dto.ts +2 -2
  708. package/models/submit-negotiation-scores-v1-request-dto.ts +2 -2
  709. package/models/supplier-card-payable-response-dto.ts +2 -2
  710. package/models/supplier-tax-type.ts +2 -2
  711. package/models/token-request-dto.ts +2 -2
  712. package/models/token-response-dto.ts +2 -2
  713. package/models/update-bid-request-dto.ts +2 -2
  714. package/models/update-bid200-response.ts +2 -2
  715. package/models/upload-file-request-dto.ts +2 -2
  716. package/models/upload-file-v1-request-dto.ts +2 -2
  717. package/models/upload-file201-response.ts +2 -2
  718. package/package.json +1 -1
  719. package/api/webhooks-api.ts +0 -636
  720. package/dist/api/webhooks-api.d.ts +0 -304
  721. package/dist/api/webhooks-api.js +0 -621
  722. package/dist/esm/api/webhooks-api.d.ts +0 -304
  723. package/dist/esm/api/webhooks-api.js +0 -614
  724. package/dist/esm/models/acknowledge-product-receipt200-response.d.ts +0 -21
  725. package/dist/esm/models/acknowledge-product-receipt200-response.js +0 -14
  726. package/dist/esm/models/acknowledge-products-request-dto.d.ts +0 -17
  727. package/dist/esm/models/acknowledge-products-request-dto.js +0 -14
  728. package/dist/esm/models/bid-published-response-dto.d.ts +0 -25
  729. package/dist/esm/models/bid-published-response-dto.js +0 -16
  730. package/dist/esm/models/contract-documents-regenerated-response-dto.d.ts +0 -21
  731. package/dist/esm/models/contract-documents-regenerated-response-dto.js +0 -14
  732. package/dist/esm/models/create-card-payment200-response.d.ts +0 -21
  733. package/dist/esm/models/create-card-payment200-response.js +0 -14
  734. package/dist/esm/models/create-webhook-endpoint-request-dto.d.ts +0 -22
  735. package/dist/esm/models/create-webhook-endpoint-request-dto.js +0 -14
  736. package/dist/esm/models/create-webhook-endpoint201-response.d.ts +0 -21
  737. package/dist/esm/models/create-webhook-endpoint201-response.js +0 -14
  738. package/dist/esm/models/get-bid-results200-response.d.ts +0 -21
  739. package/dist/esm/models/get-bid-results200-response.js +0 -14
  740. package/dist/esm/models/get-supplier-card-payable-v2200-response.d.ts +0 -21
  741. package/dist/esm/models/get-supplier-card-payable-v2200-response.js +0 -14
  742. package/dist/esm/models/get-webhook-endpoint200-response.d.ts +0 -21
  743. package/dist/esm/models/get-webhook-endpoint200-response.js +0 -14
  744. package/dist/esm/models/list-products200-response.d.ts +0 -21
  745. package/dist/esm/models/list-products200-response.js +0 -14
  746. package/dist/esm/models/list-webhook-deliveries-response-dto.d.ts +0 -22
  747. package/dist/esm/models/list-webhook-deliveries-response-dto.js +0 -14
  748. package/dist/esm/models/list-webhook-deliveries200-response.d.ts +0 -21
  749. package/dist/esm/models/list-webhook-deliveries200-response.js +0 -14
  750. package/dist/esm/models/list-webhook-endpoints200-response.d.ts +0 -21
  751. package/dist/esm/models/list-webhook-endpoints200-response.js +0 -14
  752. package/dist/esm/models/on-bid-award-reverted-request.d.ts +0 -16
  753. package/dist/esm/models/on-bid-award-reverted-request.js +0 -14
  754. package/dist/esm/models/on-bid-awarded-request.d.ts +0 -16
  755. package/dist/esm/models/on-bid-awarded-request.js +0 -14
  756. package/dist/esm/models/on-bid-canceled-request.d.ts +0 -16
  757. package/dist/esm/models/on-bid-canceled-request.js +0 -14
  758. package/dist/esm/models/on-bid-closed-request.d.ts +0 -16
  759. package/dist/esm/models/on-bid-closed-request.js +0 -14
  760. package/dist/esm/models/on-bid-failed-request.d.ts +0 -16
  761. package/dist/esm/models/on-bid-failed-request.js +0 -14
  762. package/dist/esm/models/on-ping-request.d.ts +0 -16
  763. package/dist/esm/models/on-ping-request.js +0 -14
  764. package/dist/esm/models/partner-webhook-delivery-status.d.ts +0 -18
  765. package/dist/esm/models/partner-webhook-delivery-status.js +0 -19
  766. package/dist/esm/models/partner-webhook-endpoint-status.d.ts +0 -19
  767. package/dist/esm/models/partner-webhook-endpoint-status.js +0 -20
  768. package/dist/esm/models/partner-webhook-event-type.d.ts +0 -22
  769. package/dist/esm/models/partner-webhook-event-type.js +0 -23
  770. package/dist/esm/models/product-receipt-response-dto.d.ts +0 -17
  771. package/dist/esm/models/product-receipt-response-dto.js +0 -14
  772. package/dist/esm/models/product-response-dto.d.ts +0 -77
  773. package/dist/esm/models/product-response-dto.js +0 -14
  774. package/dist/esm/models/publish-bid200-response.d.ts +0 -21
  775. package/dist/esm/models/publish-bid200-response.js +0 -14
  776. package/dist/esm/models/regenerate-contract-documents201-response.d.ts +0 -21
  777. package/dist/esm/models/regenerate-contract-documents201-response.js +0 -14
  778. package/dist/esm/models/send-webhook-test-event200-response.d.ts +0 -21
  779. package/dist/esm/models/send-webhook-test-event200-response.js +0 -14
  780. package/dist/esm/models/update-webhook-endpoint-request-dto.d.ts +0 -27
  781. package/dist/esm/models/update-webhook-endpoint-request-dto.js +0 -14
  782. package/dist/esm/models/webhook-bid-event-data.d.ts +0 -33
  783. package/dist/esm/models/webhook-bid-event-data.js +0 -14
  784. package/dist/esm/models/webhook-delivery-dto.d.ts +0 -73
  785. package/dist/esm/models/webhook-delivery-dto.js +0 -21
  786. package/dist/esm/models/webhook-endpoint-dto.d.ts +0 -55
  787. package/dist/esm/models/webhook-endpoint-dto.js +0 -14
  788. package/dist/esm/models/webhook-endpoint-with-secret-dto.d.ts +0 -59
  789. package/dist/esm/models/webhook-endpoint-with-secret-dto.js +0 -14
  790. package/dist/esm/models/webhook-event-envelope.d.ts +0 -34
  791. package/dist/esm/models/webhook-event-envelope.js +0 -14
  792. package/dist/esm/models/webhook-ping-event-data.d.ts +0 -20
  793. package/dist/esm/models/webhook-ping-event-data.js +0 -14
  794. package/dist/esm/models/webhook-test-result-dto.d.ts +0 -25
  795. package/dist/esm/models/webhook-test-result-dto.js +0 -14
  796. package/dist/models/acknowledge-product-receipt200-response.d.ts +0 -21
  797. package/dist/models/acknowledge-product-receipt200-response.js +0 -15
  798. package/dist/models/acknowledge-products-request-dto.d.ts +0 -17
  799. package/dist/models/acknowledge-products-request-dto.js +0 -15
  800. package/dist/models/bid-published-response-dto.d.ts +0 -25
  801. package/dist/models/bid-published-response-dto.js +0 -19
  802. package/dist/models/contract-documents-regenerated-response-dto.d.ts +0 -21
  803. package/dist/models/contract-documents-regenerated-response-dto.js +0 -15
  804. package/dist/models/create-card-payment200-response.d.ts +0 -21
  805. package/dist/models/create-card-payment200-response.js +0 -15
  806. package/dist/models/create-webhook-endpoint-request-dto.d.ts +0 -22
  807. package/dist/models/create-webhook-endpoint-request-dto.js +0 -15
  808. package/dist/models/create-webhook-endpoint201-response.d.ts +0 -21
  809. package/dist/models/create-webhook-endpoint201-response.js +0 -15
  810. package/dist/models/get-bid-results200-response.d.ts +0 -21
  811. package/dist/models/get-bid-results200-response.js +0 -15
  812. package/dist/models/get-supplier-card-payable-v2200-response.d.ts +0 -21
  813. package/dist/models/get-supplier-card-payable-v2200-response.js +0 -15
  814. package/dist/models/get-webhook-endpoint200-response.d.ts +0 -21
  815. package/dist/models/get-webhook-endpoint200-response.js +0 -15
  816. package/dist/models/list-products200-response.d.ts +0 -21
  817. package/dist/models/list-products200-response.js +0 -15
  818. package/dist/models/list-webhook-deliveries-response-dto.d.ts +0 -22
  819. package/dist/models/list-webhook-deliveries-response-dto.js +0 -15
  820. package/dist/models/list-webhook-deliveries200-response.d.ts +0 -21
  821. package/dist/models/list-webhook-deliveries200-response.js +0 -15
  822. package/dist/models/list-webhook-endpoints200-response.d.ts +0 -21
  823. package/dist/models/list-webhook-endpoints200-response.js +0 -15
  824. package/dist/models/on-bid-award-reverted-request.d.ts +0 -16
  825. package/dist/models/on-bid-award-reverted-request.js +0 -15
  826. package/dist/models/on-bid-awarded-request.d.ts +0 -16
  827. package/dist/models/on-bid-awarded-request.js +0 -15
  828. package/dist/models/on-bid-canceled-request.d.ts +0 -16
  829. package/dist/models/on-bid-canceled-request.js +0 -15
  830. package/dist/models/on-bid-closed-request.d.ts +0 -16
  831. package/dist/models/on-bid-closed-request.js +0 -15
  832. package/dist/models/on-bid-failed-request.d.ts +0 -16
  833. package/dist/models/on-bid-failed-request.js +0 -15
  834. package/dist/models/on-ping-request.d.ts +0 -16
  835. package/dist/models/on-ping-request.js +0 -15
  836. package/dist/models/partner-webhook-delivery-status.d.ts +0 -18
  837. package/dist/models/partner-webhook-delivery-status.js +0 -22
  838. package/dist/models/partner-webhook-endpoint-status.d.ts +0 -19
  839. package/dist/models/partner-webhook-endpoint-status.js +0 -23
  840. package/dist/models/partner-webhook-event-type.d.ts +0 -22
  841. package/dist/models/partner-webhook-event-type.js +0 -26
  842. package/dist/models/product-receipt-response-dto.d.ts +0 -17
  843. package/dist/models/product-receipt-response-dto.js +0 -15
  844. package/dist/models/product-response-dto.d.ts +0 -77
  845. package/dist/models/product-response-dto.js +0 -15
  846. package/dist/models/publish-bid200-response.d.ts +0 -21
  847. package/dist/models/publish-bid200-response.js +0 -15
  848. package/dist/models/regenerate-contract-documents201-response.d.ts +0 -21
  849. package/dist/models/regenerate-contract-documents201-response.js +0 -15
  850. package/dist/models/send-webhook-test-event200-response.d.ts +0 -21
  851. package/dist/models/send-webhook-test-event200-response.js +0 -15
  852. package/dist/models/update-webhook-endpoint-request-dto.d.ts +0 -27
  853. package/dist/models/update-webhook-endpoint-request-dto.js +0 -15
  854. package/dist/models/webhook-bid-event-data.d.ts +0 -33
  855. package/dist/models/webhook-bid-event-data.js +0 -15
  856. package/dist/models/webhook-delivery-dto.d.ts +0 -73
  857. package/dist/models/webhook-delivery-dto.js +0 -24
  858. package/dist/models/webhook-endpoint-dto.d.ts +0 -55
  859. package/dist/models/webhook-endpoint-dto.js +0 -15
  860. package/dist/models/webhook-endpoint-with-secret-dto.d.ts +0 -59
  861. package/dist/models/webhook-endpoint-with-secret-dto.js +0 -15
  862. package/dist/models/webhook-event-envelope.d.ts +0 -34
  863. package/dist/models/webhook-event-envelope.js +0 -15
  864. package/dist/models/webhook-ping-event-data.d.ts +0 -20
  865. package/dist/models/webhook-ping-event-data.js +0 -15
  866. package/dist/models/webhook-test-result-dto.d.ts +0 -25
  867. package/dist/models/webhook-test-result-dto.js +0 -15
  868. package/docs/AcknowledgeProductReceipt200Response.md +0 -22
  869. package/docs/AcknowledgeProductsRequestDto.md +0 -20
  870. package/docs/BidPublishedResponseDto.md +0 -22
  871. package/docs/ContractDocumentsRegeneratedResponseDto.md +0 -22
  872. package/docs/CreateCardPayment200Response.md +0 -22
  873. package/docs/CreateWebhookEndpoint201Response.md +0 -22
  874. package/docs/CreateWebhookEndpointRequestDto.md +0 -22
  875. package/docs/GetBidResults200Response.md +0 -22
  876. package/docs/GetSupplierCardPayableV2200Response.md +0 -22
  877. package/docs/GetWebhookEndpoint200Response.md +0 -22
  878. package/docs/ListProducts200Response.md +0 -22
  879. package/docs/ListWebhookDeliveries200Response.md +0 -22
  880. package/docs/ListWebhookDeliveriesResponseDto.md +0 -22
  881. package/docs/ListWebhookEndpoints200Response.md +0 -22
  882. package/docs/OnBidAwardRevertedRequest.md +0 -26
  883. package/docs/OnBidAwardedRequest.md +0 -26
  884. package/docs/OnBidCanceledRequest.md +0 -26
  885. package/docs/OnBidClosedRequest.md +0 -26
  886. package/docs/OnBidFailedRequest.md +0 -26
  887. package/docs/OnPingRequest.md +0 -26
  888. package/docs/PartnerWebhookDeliveryStatus.md +0 -14
  889. package/docs/PartnerWebhookEndpointStatus.md +0 -11
  890. package/docs/PartnerWebhookEventType.md +0 -17
  891. package/docs/ProductReceiptResponseDto.md +0 -20
  892. package/docs/ProductResponseDto.md +0 -50
  893. package/docs/PublishBid200Response.md +0 -22
  894. package/docs/RegenerateContractDocuments201Response.md +0 -22
  895. package/docs/SendWebhookTestEvent200Response.md +0 -22
  896. package/docs/UpdateWebhookEndpointRequestDto.md +0 -24
  897. package/docs/WebhookBidEventData.md +0 -27
  898. package/docs/WebhookDeliveryDto.md +0 -42
  899. package/docs/WebhookEndpointDto.md +0 -38
  900. package/docs/WebhookEndpointWithSecretDto.md +0 -40
  901. package/docs/WebhookEventEnvelope.md +0 -27
  902. package/docs/WebhookPingEventData.md +0 -21
  903. package/docs/WebhookTestResultDto.md +0 -24
  904. package/docs/WebhooksApi.md +0 -385
  905. package/models/acknowledge-product-receipt200-response.ts +0 -27
  906. package/models/acknowledge-products-request-dto.ts +0 -23
  907. package/models/bid-published-response-dto.ts +0 -34
  908. package/models/contract-documents-regenerated-response-dto.ts +0 -27
  909. package/models/create-card-payment200-response.ts +0 -27
  910. package/models/create-webhook-endpoint-request-dto.ts +0 -30
  911. package/models/create-webhook-endpoint201-response.ts +0 -27
  912. package/models/get-bid-results200-response.ts +0 -27
  913. package/models/get-supplier-card-payable-v2200-response.ts +0 -27
  914. package/models/get-webhook-endpoint200-response.ts +0 -27
  915. package/models/list-products200-response.ts +0 -27
  916. package/models/list-webhook-deliveries-response-dto.ts +0 -30
  917. package/models/list-webhook-deliveries200-response.ts +0 -27
  918. package/models/list-webhook-endpoints200-response.ts +0 -27
  919. package/models/on-bid-award-reverted-request.ts +0 -28
  920. package/models/on-bid-awarded-request.ts +0 -28
  921. package/models/on-bid-canceled-request.ts +0 -28
  922. package/models/on-bid-closed-request.ts +0 -28
  923. package/models/on-bid-failed-request.ts +0 -28
  924. package/models/on-ping-request.ts +0 -28
  925. package/models/partner-webhook-delivery-status.ts +0 -28
  926. package/models/partner-webhook-endpoint-status.ts +0 -29
  927. package/models/partner-webhook-event-type.ts +0 -32
  928. package/models/product-receipt-response-dto.ts +0 -23
  929. package/models/product-response-dto.ts +0 -83
  930. package/models/publish-bid200-response.ts +0 -27
  931. package/models/regenerate-contract-documents201-response.ts +0 -27
  932. package/models/send-webhook-test-event200-response.ts +0 -27
  933. package/models/update-webhook-endpoint-request-dto.ts +0 -39
  934. package/models/webhook-bid-event-data.ts +0 -43
  935. package/models/webhook-delivery-dto.ts +0 -82
  936. package/models/webhook-endpoint-dto.ts +0 -67
  937. package/models/webhook-endpoint-with-secret-dto.ts +0 -71
  938. package/models/webhook-event-envelope.ts +0 -38
  939. package/models/webhook-ping-event-data.ts +0 -26
  940. package/models/webhook-test-result-dto.ts +0 -31
@@ -3,9 +3,9 @@
3
3
  /* eslint-disable */
4
4
  /**
5
5
  * CMARKET V6 Partner API
6
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 33.1.0
8
+ * The version of the OpenAPI document: 35.0.0
9
9
  * Contact: semo.io.kr@gmail.com
10
10
  *
11
11
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
3
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 33.1.0
5
+ * The version of the OpenAPI document: 35.0.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -3,9 +3,9 @@
3
3
  /* eslint-disable */
4
4
  /**
5
5
  * CMARKET V6 Partner API
6
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 33.1.0
8
+ * The version of the OpenAPI document: 35.0.0
9
9
  * Contact: semo.io.kr@gmail.com
10
10
  *
11
11
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
3
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 33.1.0
5
+ * The version of the OpenAPI document: 35.0.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -3,9 +3,9 @@
3
3
  /* eslint-disable */
4
4
  /**
5
5
  * CMARKET V6 Partner API
6
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 33.1.0
8
+ * The version of the OpenAPI document: 35.0.0
9
9
  * Contact: semo.io.kr@gmail.com
10
10
  *
11
11
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
3
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 33.1.0
5
+ * The version of the OpenAPI document: 35.0.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -3,9 +3,9 @@
3
3
  /* eslint-disable */
4
4
  /**
5
5
  * CMARKET V6 Partner API
6
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 33.1.0
8
+ * The version of the OpenAPI document: 35.0.0
9
9
  * Contact: semo.io.kr@gmail.com
10
10
  *
11
11
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -1,7 +1,5 @@
1
1
  export * from './acceptance-result-response-dto';
2
2
  export * from './acceptance-result-v1-response-dto';
3
- export * from './acknowledge-product-receipt200-response';
4
- export * from './acknowledge-products-request-dto';
5
3
  export * from './acknowledge-products-v1-request-dto';
6
4
  export * from './api-catalog-dto';
7
5
  export * from './api-catalog-entry-dto';
@@ -37,7 +35,6 @@ export * from './bid-manager-v1-dto';
37
35
  export * from './bid-payment-terms-dto';
38
36
  export * from './bid-product-dto';
39
37
  export * from './bid-public-status';
40
- export * from './bid-published-response-dto';
41
38
  export * from './bid-registered-response-dto';
42
39
  export * from './bid-result-participant-attachment-dto';
43
40
  export * from './bid-result-participant-dto';
@@ -64,16 +61,12 @@ export * from './complete-acceptance-request-dto';
64
61
  export * from './complete-acceptance-v1-request-dto';
65
62
  export * from './complete-invoice200-response';
66
63
  export * from './contract-document-item-dto';
67
- export * from './contract-documents-regenerated-response-dto';
68
64
  export * from './contract-restriction-confirm-input-dto';
69
65
  export * from './create-bid-request-dto';
70
66
  export * from './create-bid-v1-request-dto';
71
- export * from './create-card-payment200-response';
72
67
  export * from './create-card-payment-request-dto';
73
68
  export * from './create-external-contract-documents-request-dto';
74
69
  export * from './create-external-contract-documents-response-dto';
75
- export * from './create-webhook-endpoint201-response';
76
- export * from './create-webhook-endpoint-request-dto';
77
70
  export * from './external-contract-document-item-dto';
78
71
  export * from './external-contract-documents-response-dto';
79
72
  export * from './external-contract-item-dto';
@@ -84,12 +77,9 @@ export * from './file-uploaded-response-dto';
84
77
  export * from './file-uploaded-v1-response-dto';
85
78
  export * from './generated-external-contract-document-dto';
86
79
  export * from './get-bid200-response';
87
- export * from './get-bid-results200-response';
88
80
  export * from './get-bid-settlement200-response';
89
81
  export * from './get-bid-statement200-response';
90
82
  export * from './get-file-meta200-response';
91
- export * from './get-supplier-card-payable-v2200-response';
92
- export * from './get-webhook-endpoint200-response';
93
83
  export * from './health-controller-check200-response';
94
84
  export * from './health-response-dto';
95
85
  export * from './hierarchical-region-dto';
@@ -101,35 +91,18 @@ export * from './invoice-completed-response-dto';
101
91
  export * from './list-bid-results200-response';
102
92
  export * from './list-bids200-response';
103
93
  export * from './list-bids-response-dto';
104
- export * from './list-products200-response';
105
- export * from './list-webhook-deliveries200-response';
106
- export * from './list-webhook-deliveries-response-dto';
107
- export * from './list-webhook-endpoints200-response';
108
94
  export * from './mark-bid-failed201-response';
109
95
  export * from './mark-bid-failed-request-dto';
110
96
  export * from './mark-bid-failed-v1-request-dto';
111
97
  export * from './negotiation-score-v1-dto';
112
98
  export * from './negotiation-scored-response-dto';
113
99
  export * from './oauth-error-response-dto';
114
- export * from './on-bid-award-reverted-request';
115
- export * from './on-bid-awarded-request';
116
- export * from './on-bid-canceled-request';
117
- export * from './on-bid-closed-request';
118
- export * from './on-bid-failed-request';
119
- export * from './on-ping-request';
120
- export * from './partner-webhook-delivery-status';
121
- export * from './partner-webhook-endpoint-status';
122
- export * from './partner-webhook-event-type';
123
100
  export * from './preconditions-dto';
124
101
  export * from './preconditions-v1-dto';
125
102
  export * from './problem-details-dto';
126
- export * from './product-receipt-response-dto';
127
103
  export * from './product-receipt-v1-response-dto';
128
- export * from './product-response-dto';
129
104
  export * from './product-v1-response-dto';
130
105
  export * from './protected-resource-metadata-dto';
131
- export * from './publish-bid200-response';
132
- export * from './regenerate-contract-documents201-response';
133
106
  export * from './register-award201-response';
134
107
  export * from './register-award-request-dto';
135
108
  export * from './register-award-v1-request-dto';
@@ -143,7 +116,6 @@ export * from './revert-award-request-dto';
143
116
  export * from './revoke-request-dto';
144
117
  export * from './semo-contract-registered-response-dto';
145
118
  export * from './semo-contract-taxinvoice-status-response-dto';
146
- export * from './send-webhook-test-event200-response';
147
119
  export * from './split-invoice-v1-response-dto';
148
120
  export * from './statement-document-dto';
149
121
  export * from './statement-product-dto';
@@ -156,14 +128,6 @@ export * from './token-request-dto';
156
128
  export * from './token-response-dto';
157
129
  export * from './update-bid200-response';
158
130
  export * from './update-bid-request-dto';
159
- export * from './update-webhook-endpoint-request-dto';
160
131
  export * from './upload-file201-response';
161
132
  export * from './upload-file-request-dto';
162
133
  export * from './upload-file-v1-request-dto';
163
- export * from './webhook-bid-event-data';
164
- export * from './webhook-delivery-dto';
165
- export * from './webhook-endpoint-dto';
166
- export * from './webhook-endpoint-with-secret-dto';
167
- export * from './webhook-event-envelope';
168
- export * from './webhook-ping-event-data';
169
- export * from './webhook-test-result-dto';
@@ -16,8 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
17
  __exportStar(require("./acceptance-result-response-dto"), exports);
18
18
  __exportStar(require("./acceptance-result-v1-response-dto"), exports);
19
- __exportStar(require("./acknowledge-product-receipt200-response"), exports);
20
- __exportStar(require("./acknowledge-products-request-dto"), exports);
21
19
  __exportStar(require("./acknowledge-products-v1-request-dto"), exports);
22
20
  __exportStar(require("./api-catalog-dto"), exports);
23
21
  __exportStar(require("./api-catalog-entry-dto"), exports);
@@ -53,7 +51,6 @@ __exportStar(require("./bid-manager-v1-dto"), exports);
53
51
  __exportStar(require("./bid-payment-terms-dto"), exports);
54
52
  __exportStar(require("./bid-product-dto"), exports);
55
53
  __exportStar(require("./bid-public-status"), exports);
56
- __exportStar(require("./bid-published-response-dto"), exports);
57
54
  __exportStar(require("./bid-registered-response-dto"), exports);
58
55
  __exportStar(require("./bid-result-participant-attachment-dto"), exports);
59
56
  __exportStar(require("./bid-result-participant-dto"), exports);
@@ -80,16 +77,12 @@ __exportStar(require("./complete-acceptance-request-dto"), exports);
80
77
  __exportStar(require("./complete-acceptance-v1-request-dto"), exports);
81
78
  __exportStar(require("./complete-invoice200-response"), exports);
82
79
  __exportStar(require("./contract-document-item-dto"), exports);
83
- __exportStar(require("./contract-documents-regenerated-response-dto"), exports);
84
80
  __exportStar(require("./contract-restriction-confirm-input-dto"), exports);
85
81
  __exportStar(require("./create-bid-request-dto"), exports);
86
82
  __exportStar(require("./create-bid-v1-request-dto"), exports);
87
- __exportStar(require("./create-card-payment200-response"), exports);
88
83
  __exportStar(require("./create-card-payment-request-dto"), exports);
89
84
  __exportStar(require("./create-external-contract-documents-request-dto"), exports);
90
85
  __exportStar(require("./create-external-contract-documents-response-dto"), exports);
91
- __exportStar(require("./create-webhook-endpoint201-response"), exports);
92
- __exportStar(require("./create-webhook-endpoint-request-dto"), exports);
93
86
  __exportStar(require("./external-contract-document-item-dto"), exports);
94
87
  __exportStar(require("./external-contract-documents-response-dto"), exports);
95
88
  __exportStar(require("./external-contract-item-dto"), exports);
@@ -100,12 +93,9 @@ __exportStar(require("./file-uploaded-response-dto"), exports);
100
93
  __exportStar(require("./file-uploaded-v1-response-dto"), exports);
101
94
  __exportStar(require("./generated-external-contract-document-dto"), exports);
102
95
  __exportStar(require("./get-bid200-response"), exports);
103
- __exportStar(require("./get-bid-results200-response"), exports);
104
96
  __exportStar(require("./get-bid-settlement200-response"), exports);
105
97
  __exportStar(require("./get-bid-statement200-response"), exports);
106
98
  __exportStar(require("./get-file-meta200-response"), exports);
107
- __exportStar(require("./get-supplier-card-payable-v2200-response"), exports);
108
- __exportStar(require("./get-webhook-endpoint200-response"), exports);
109
99
  __exportStar(require("./health-controller-check200-response"), exports);
110
100
  __exportStar(require("./health-response-dto"), exports);
111
101
  __exportStar(require("./hierarchical-region-dto"), exports);
@@ -117,35 +107,18 @@ __exportStar(require("./invoice-completed-response-dto"), exports);
117
107
  __exportStar(require("./list-bid-results200-response"), exports);
118
108
  __exportStar(require("./list-bids200-response"), exports);
119
109
  __exportStar(require("./list-bids-response-dto"), exports);
120
- __exportStar(require("./list-products200-response"), exports);
121
- __exportStar(require("./list-webhook-deliveries200-response"), exports);
122
- __exportStar(require("./list-webhook-deliveries-response-dto"), exports);
123
- __exportStar(require("./list-webhook-endpoints200-response"), exports);
124
110
  __exportStar(require("./mark-bid-failed201-response"), exports);
125
111
  __exportStar(require("./mark-bid-failed-request-dto"), exports);
126
112
  __exportStar(require("./mark-bid-failed-v1-request-dto"), exports);
127
113
  __exportStar(require("./negotiation-score-v1-dto"), exports);
128
114
  __exportStar(require("./negotiation-scored-response-dto"), exports);
129
115
  __exportStar(require("./oauth-error-response-dto"), exports);
130
- __exportStar(require("./on-bid-award-reverted-request"), exports);
131
- __exportStar(require("./on-bid-awarded-request"), exports);
132
- __exportStar(require("./on-bid-canceled-request"), exports);
133
- __exportStar(require("./on-bid-closed-request"), exports);
134
- __exportStar(require("./on-bid-failed-request"), exports);
135
- __exportStar(require("./on-ping-request"), exports);
136
- __exportStar(require("./partner-webhook-delivery-status"), exports);
137
- __exportStar(require("./partner-webhook-endpoint-status"), exports);
138
- __exportStar(require("./partner-webhook-event-type"), exports);
139
116
  __exportStar(require("./preconditions-dto"), exports);
140
117
  __exportStar(require("./preconditions-v1-dto"), exports);
141
118
  __exportStar(require("./problem-details-dto"), exports);
142
- __exportStar(require("./product-receipt-response-dto"), exports);
143
119
  __exportStar(require("./product-receipt-v1-response-dto"), exports);
144
- __exportStar(require("./product-response-dto"), exports);
145
120
  __exportStar(require("./product-v1-response-dto"), exports);
146
121
  __exportStar(require("./protected-resource-metadata-dto"), exports);
147
- __exportStar(require("./publish-bid200-response"), exports);
148
- __exportStar(require("./regenerate-contract-documents201-response"), exports);
149
122
  __exportStar(require("./register-award201-response"), exports);
150
123
  __exportStar(require("./register-award-request-dto"), exports);
151
124
  __exportStar(require("./register-award-v1-request-dto"), exports);
@@ -159,7 +132,6 @@ __exportStar(require("./revert-award-request-dto"), exports);
159
132
  __exportStar(require("./revoke-request-dto"), exports);
160
133
  __exportStar(require("./semo-contract-registered-response-dto"), exports);
161
134
  __exportStar(require("./semo-contract-taxinvoice-status-response-dto"), exports);
162
- __exportStar(require("./send-webhook-test-event200-response"), exports);
163
135
  __exportStar(require("./split-invoice-v1-response-dto"), exports);
164
136
  __exportStar(require("./statement-document-dto"), exports);
165
137
  __exportStar(require("./statement-product-dto"), exports);
@@ -172,14 +144,6 @@ __exportStar(require("./token-request-dto"), exports);
172
144
  __exportStar(require("./token-response-dto"), exports);
173
145
  __exportStar(require("./update-bid200-response"), exports);
174
146
  __exportStar(require("./update-bid-request-dto"), exports);
175
- __exportStar(require("./update-webhook-endpoint-request-dto"), exports);
176
147
  __exportStar(require("./upload-file201-response"), exports);
177
148
  __exportStar(require("./upload-file-request-dto"), exports);
178
149
  __exportStar(require("./upload-file-v1-request-dto"), exports);
179
- __exportStar(require("./webhook-bid-event-data"), exports);
180
- __exportStar(require("./webhook-delivery-dto"), exports);
181
- __exportStar(require("./webhook-endpoint-dto"), exports);
182
- __exportStar(require("./webhook-endpoint-with-secret-dto"), exports);
183
- __exportStar(require("./webhook-event-envelope"), exports);
184
- __exportStar(require("./webhook-ping-event-data"), exports);
185
- __exportStar(require("./webhook-test-result-dto"), exports);
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
3
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 33.1.0
5
+ * The version of the OpenAPI document: 35.0.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -3,9 +3,9 @@
3
3
  /* eslint-disable */
4
4
  /**
5
5
  * CMARKET V6 Partner API
6
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 33.1.0
8
+ * The version of the OpenAPI document: 35.0.0
9
9
  * Contact: semo.io.kr@gmail.com
10
10
  *
11
11
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
3
+ * 외부 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 33.1.0
5
+ * The version of the OpenAPI document: 35.0.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).