@cmarket/partner-sdk 22.6.0 → 22.8.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 (612) hide show
  1. package/README.md +10 -4
  2. package/api/oauth-api.ts +72 -1
  3. package/api/partner-v1-api.ts +1 -1
  4. package/api/partner-v2-api.ts +1 -1
  5. package/api/well-known-api.ts +180 -0
  6. package/api.ts +2 -1
  7. package/base.ts +1 -1
  8. package/common.ts +1 -1
  9. package/configuration.ts +1 -1
  10. package/dist/api/oauth-api.d.ts +34 -1
  11. package/dist/api/oauth-api.js +68 -1
  12. package/dist/api/partner-v1-api.d.ts +1 -1
  13. package/dist/api/partner-v1-api.js +1 -1
  14. package/dist/api/partner-v2-api.d.ts +1 -1
  15. package/dist/api/partner-v2-api.js +1 -1
  16. package/dist/api/well-known-api.d.ts +92 -0
  17. package/dist/api/well-known-api.js +181 -0
  18. package/dist/api.d.ts +2 -1
  19. package/dist/api.js +2 -1
  20. package/dist/base.d.ts +1 -1
  21. package/dist/base.js +1 -1
  22. package/dist/common.d.ts +1 -1
  23. package/dist/common.js +1 -1
  24. package/dist/configuration.d.ts +1 -1
  25. package/dist/configuration.js +1 -1
  26. package/dist/esm/api/oauth-api.d.ts +34 -1
  27. package/dist/esm/api/oauth-api.js +68 -1
  28. package/dist/esm/api/partner-v1-api.d.ts +1 -1
  29. package/dist/esm/api/partner-v1-api.js +1 -1
  30. package/dist/esm/api/partner-v2-api.d.ts +1 -1
  31. package/dist/esm/api/partner-v2-api.js +1 -1
  32. package/dist/esm/api/well-known-api.d.ts +92 -0
  33. package/dist/esm/api/well-known-api.js +174 -0
  34. package/dist/esm/api.d.ts +2 -1
  35. package/dist/esm/api.js +2 -1
  36. package/dist/esm/base.d.ts +1 -1
  37. package/dist/esm/base.js +1 -1
  38. package/dist/esm/common.d.ts +1 -1
  39. package/dist/esm/common.js +1 -1
  40. package/dist/esm/configuration.d.ts +1 -1
  41. package/dist/esm/configuration.js +1 -1
  42. package/dist/esm/index.d.ts +1 -1
  43. package/dist/esm/index.js +1 -1
  44. package/dist/esm/models/acceptance-result-response-dto.d.ts +1 -1
  45. package/dist/esm/models/acceptance-result-response-dto.js +1 -1
  46. package/dist/esm/models/acceptance-result-v1-response-dto.d.ts +1 -1
  47. package/dist/esm/models/acceptance-result-v1-response-dto.js +1 -1
  48. package/dist/esm/models/acknowledge-products-v1-request-dto.d.ts +1 -1
  49. package/dist/esm/models/acknowledge-products-v1-request-dto.js +1 -1
  50. package/dist/esm/models/authorization-server-metadata-dto.d.ts +49 -0
  51. package/dist/esm/models/authorization-server-metadata-dto.js +14 -0
  52. package/dist/esm/models/award-method-public.d.ts +1 -1
  53. package/dist/esm/models/award-method-public.js +1 -1
  54. package/dist/esm/models/award-registered-response-dto.d.ts +1 -1
  55. package/dist/esm/models/award-registered-response-dto.js +1 -1
  56. package/dist/esm/models/award-registered-v2-response-dto.d.ts +1 -1
  57. package/dist/esm/models/award-registered-v2-response-dto.js +1 -1
  58. package/dist/esm/models/bid-attachment-v1-dto.d.ts +1 -1
  59. package/dist/esm/models/bid-attachment-v1-dto.js +1 -1
  60. package/dist/esm/models/bid-bond-dto.d.ts +1 -1
  61. package/dist/esm/models/bid-bond-dto.js +1 -1
  62. package/dist/esm/models/bid-bond-v1-dto.d.ts +1 -1
  63. package/dist/esm/models/bid-bond-v1-dto.js +1 -1
  64. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.d.ts +1 -1
  65. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.js +1 -1
  66. package/dist/esm/models/bid-contract-documents-v1-response-dto.d.ts +1 -1
  67. package/dist/esm/models/bid-contract-documents-v1-response-dto.js +1 -1
  68. package/dist/esm/models/bid-created-response-dto.d.ts +1 -1
  69. package/dist/esm/models/bid-created-response-dto.js +1 -1
  70. package/dist/esm/models/bid-detail-response-dto.d.ts +1 -1
  71. package/dist/esm/models/bid-detail-response-dto.js +1 -1
  72. package/dist/esm/models/bid-document-dto.d.ts +1 -1
  73. package/dist/esm/models/bid-document-dto.js +1 -1
  74. package/dist/esm/models/bid-document-v1-dto.d.ts +1 -1
  75. package/dist/esm/models/bid-document-v1-dto.js +1 -1
  76. package/dist/esm/models/bid-failed-response-dto.d.ts +1 -1
  77. package/dist/esm/models/bid-failed-response-dto.js +1 -1
  78. package/dist/esm/models/bid-failed-v2-response-dto.d.ts +1 -1
  79. package/dist/esm/models/bid-failed-v2-response-dto.js +1 -1
  80. package/dist/esm/models/bid-failure-reason.d.ts +1 -1
  81. package/dist/esm/models/bid-failure-reason.js +1 -1
  82. package/dist/esm/models/bid-item-dto.d.ts +1 -1
  83. package/dist/esm/models/bid-item-dto.js +1 -1
  84. package/dist/esm/models/bid-item-v1-dto.d.ts +1 -1
  85. package/dist/esm/models/bid-item-v1-dto.js +1 -1
  86. package/dist/esm/models/bid-lifecycle-dto.d.ts +1 -1
  87. package/dist/esm/models/bid-lifecycle-dto.js +1 -1
  88. package/dist/esm/models/bid-manager-dto.d.ts +1 -1
  89. package/dist/esm/models/bid-manager-dto.js +1 -1
  90. package/dist/esm/models/bid-manager-v1-dto.d.ts +1 -1
  91. package/dist/esm/models/bid-manager-v1-dto.js +1 -1
  92. package/dist/esm/models/bid-participant-summary-dto.d.ts +1 -1
  93. package/dist/esm/models/bid-participant-summary-dto.js +1 -1
  94. package/dist/esm/models/bid-public-status.d.ts +1 -1
  95. package/dist/esm/models/bid-public-status.js +1 -1
  96. package/dist/esm/models/bid-published-response-dto.d.ts +1 -1
  97. package/dist/esm/models/bid-published-response-dto.js +1 -1
  98. package/dist/esm/models/bid-registered-response-dto.d.ts +1 -1
  99. package/dist/esm/models/bid-registered-response-dto.js +1 -1
  100. package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +1 -1
  101. package/dist/esm/models/bid-result-participant-attachment-dto.js +1 -1
  102. package/dist/esm/models/bid-result-participant-dto.d.ts +1 -1
  103. package/dist/esm/models/bid-result-participant-dto.js +1 -1
  104. package/dist/esm/models/bid-result-v1-attachment-dto.d.ts +1 -1
  105. package/dist/esm/models/bid-result-v1-attachment-dto.js +1 -1
  106. package/dist/esm/models/bid-result-v1-bid-product-info-dto.d.ts +1 -1
  107. package/dist/esm/models/bid-result-v1-bid-product-info-dto.js +1 -1
  108. package/dist/esm/models/bid-result-v1-participant-dto.d.ts +1 -1
  109. package/dist/esm/models/bid-result-v1-participant-dto.js +1 -1
  110. package/dist/esm/models/bid-result-v1-product-dto.d.ts +1 -1
  111. package/dist/esm/models/bid-result-v1-product-dto.js +1 -1
  112. package/dist/esm/models/bid-results-batch-v1-request-dto.d.ts +1 -1
  113. package/dist/esm/models/bid-results-batch-v1-request-dto.js +1 -1
  114. package/dist/esm/models/bid-results-response-dto.d.ts +1 -1
  115. package/dist/esm/models/bid-results-response-dto.js +1 -1
  116. package/dist/esm/models/bid-results-v1-response-dto.d.ts +1 -1
  117. package/dist/esm/models/bid-results-v1-response-dto.js +1 -1
  118. package/dist/esm/models/bid-settlement-line-item-dto.d.ts +1 -1
  119. package/dist/esm/models/bid-settlement-line-item-dto.js +1 -1
  120. package/dist/esm/models/bid-settlement-participant-dto.d.ts +1 -1
  121. package/dist/esm/models/bid-settlement-participant-dto.js +1 -1
  122. package/dist/esm/models/bid-settlement-response-dto.d.ts +1 -1
  123. package/dist/esm/models/bid-settlement-response-dto.js +1 -1
  124. package/dist/esm/models/bid-statement-response-dto.d.ts +1 -1
  125. package/dist/esm/models/bid-statement-response-dto.js +1 -1
  126. package/dist/esm/models/bid-statement-v1-response-dto.d.ts +1 -1
  127. package/dist/esm/models/bid-statement-v1-response-dto.js +1 -1
  128. package/dist/esm/models/bid-status.d.ts +1 -1
  129. package/dist/esm/models/bid-status.js +1 -1
  130. package/dist/esm/models/bid-summary-dto.d.ts +1 -1
  131. package/dist/esm/models/bid-summary-dto.js +1 -1
  132. package/dist/esm/models/bid-updated-response-dto.d.ts +1 -1
  133. package/dist/esm/models/bid-updated-response-dto.js +1 -1
  134. package/dist/esm/models/card-payment-request-response-dto.d.ts +1 -1
  135. package/dist/esm/models/card-payment-request-response-dto.js +1 -1
  136. package/dist/esm/models/close-sandbox-bid-response-dto.d.ts +1 -1
  137. package/dist/esm/models/close-sandbox-bid-response-dto.js +1 -1
  138. package/dist/esm/models/complete-acceptance-request-dto.d.ts +1 -1
  139. package/dist/esm/models/complete-acceptance-request-dto.js +1 -1
  140. package/dist/esm/models/complete-acceptance-v1-request-dto.d.ts +1 -1
  141. package/dist/esm/models/complete-acceptance-v1-request-dto.js +1 -1
  142. package/dist/esm/models/contract-document-item-dto.d.ts +1 -1
  143. package/dist/esm/models/contract-document-item-dto.js +1 -1
  144. package/dist/esm/models/contract-documents-regenerated-response-dto.d.ts +1 -1
  145. package/dist/esm/models/contract-documents-regenerated-response-dto.js +1 -1
  146. package/dist/esm/models/contract-restriction-confirm-input-dto.d.ts +1 -1
  147. package/dist/esm/models/contract-restriction-confirm-input-dto.js +1 -1
  148. package/dist/esm/models/create-bid-request-dto.d.ts +1 -1
  149. package/dist/esm/models/create-bid-request-dto.js +1 -1
  150. package/dist/esm/models/create-bid-v1-request-dto.d.ts +1 -1
  151. package/dist/esm/models/create-bid-v1-request-dto.js +1 -1
  152. package/dist/esm/models/create-card-payment-request-dto.d.ts +1 -1
  153. package/dist/esm/models/create-card-payment-request-dto.js +1 -1
  154. package/dist/esm/models/create-external-contract-documents-request-dto.d.ts +1 -1
  155. package/dist/esm/models/create-external-contract-documents-request-dto.js +1 -1
  156. package/dist/esm/models/create-external-contract-documents-response-dto.d.ts +1 -1
  157. package/dist/esm/models/create-external-contract-documents-response-dto.js +1 -1
  158. package/dist/esm/models/embed-launch-request-dto.d.ts +1 -1
  159. package/dist/esm/models/embed-launch-request-dto.js +1 -1
  160. package/dist/esm/models/embed-launch-response-dto.d.ts +1 -1
  161. package/dist/esm/models/embed-launch-response-dto.js +1 -1
  162. package/dist/esm/models/external-contract-document-item-dto.d.ts +1 -1
  163. package/dist/esm/models/external-contract-document-item-dto.js +1 -1
  164. package/dist/esm/models/external-contract-documents-response-dto.d.ts +1 -1
  165. package/dist/esm/models/external-contract-documents-response-dto.js +1 -1
  166. package/dist/esm/models/external-contract-item-dto.d.ts +1 -1
  167. package/dist/esm/models/external-contract-item-dto.js +1 -1
  168. package/dist/esm/models/external-contract-snapshot-dto.d.ts +1 -1
  169. package/dist/esm/models/external-contract-snapshot-dto.js +1 -1
  170. package/dist/esm/models/external-document-inputs-dto.d.ts +1 -1
  171. package/dist/esm/models/external-document-inputs-dto.js +1 -1
  172. package/dist/esm/models/file-uploaded-response-dto.d.ts +1 -1
  173. package/dist/esm/models/file-uploaded-response-dto.js +1 -1
  174. package/dist/esm/models/file-uploaded-v1-response-dto.d.ts +1 -1
  175. package/dist/esm/models/file-uploaded-v1-response-dto.js +1 -1
  176. package/dist/esm/models/generated-external-contract-document-dto.d.ts +1 -1
  177. package/dist/esm/models/generated-external-contract-document-dto.js +1 -1
  178. package/dist/esm/models/health-response-dto.d.ts +1 -1
  179. package/dist/esm/models/health-response-dto.js +1 -1
  180. package/dist/esm/models/hierarchical-region-dto.d.ts +1 -1
  181. package/dist/esm/models/hierarchical-region-dto.js +1 -1
  182. package/dist/esm/models/hierarchical-region-v1-dto.d.ts +1 -1
  183. package/dist/esm/models/hierarchical-region-v1-dto.js +1 -1
  184. package/dist/esm/models/index.d.ts +3 -0
  185. package/dist/esm/models/index.js +3 -0
  186. package/dist/esm/models/invalid-param-dto.d.ts +1 -1
  187. package/dist/esm/models/invalid-param-dto.js +1 -1
  188. package/dist/esm/models/invoice-completed-response-dto.d.ts +1 -1
  189. package/dist/esm/models/invoice-completed-response-dto.js +1 -1
  190. package/dist/esm/models/issue-tax-invoice-request-dto.d.ts +1 -1
  191. package/dist/esm/models/issue-tax-invoice-request-dto.js +1 -1
  192. package/dist/esm/models/list-bids-response-dto.d.ts +1 -1
  193. package/dist/esm/models/list-bids-response-dto.js +1 -1
  194. package/dist/esm/models/mark-bid-failed-request-dto.d.ts +1 -1
  195. package/dist/esm/models/mark-bid-failed-request-dto.js +1 -1
  196. package/dist/esm/models/mark-bid-failed-v1-request-dto.d.ts +1 -1
  197. package/dist/esm/models/mark-bid-failed-v1-request-dto.js +1 -1
  198. package/dist/esm/models/negotiation-score-dto.d.ts +1 -1
  199. package/dist/esm/models/negotiation-score-dto.js +1 -1
  200. package/dist/esm/models/negotiation-score-v1-dto.d.ts +1 -1
  201. package/dist/esm/models/negotiation-score-v1-dto.js +1 -1
  202. package/dist/esm/models/negotiation-scored-response-dto.d.ts +1 -1
  203. package/dist/esm/models/negotiation-scored-response-dto.js +1 -1
  204. package/dist/esm/models/negotiation-scored-v2-response-dto.d.ts +1 -1
  205. package/dist/esm/models/negotiation-scored-v2-response-dto.js +1 -1
  206. package/dist/esm/models/oauth-error-response-dto.d.ts +1 -1
  207. package/dist/esm/models/oauth-error-response-dto.js +1 -1
  208. package/dist/esm/models/preconditions-dto.d.ts +1 -1
  209. package/dist/esm/models/preconditions-dto.js +1 -1
  210. package/dist/esm/models/preconditions-v1-dto.d.ts +1 -1
  211. package/dist/esm/models/preconditions-v1-dto.js +1 -1
  212. package/dist/esm/models/problem-details-dto.d.ts +1 -1
  213. package/dist/esm/models/problem-details-dto.js +1 -1
  214. package/dist/esm/models/product-receipt-v1-response-dto.d.ts +1 -1
  215. package/dist/esm/models/product-receipt-v1-response-dto.js +1 -1
  216. package/dist/esm/models/product-v1-response-dto.d.ts +1 -1
  217. package/dist/esm/models/product-v1-response-dto.js +1 -1
  218. package/dist/esm/models/protected-resource-metadata-dto.d.ts +41 -0
  219. package/dist/esm/models/protected-resource-metadata-dto.js +14 -0
  220. package/dist/esm/models/register-award-request-dto.d.ts +1 -1
  221. package/dist/esm/models/register-award-request-dto.js +1 -1
  222. package/dist/esm/models/register-award-v1-request-dto.d.ts +1 -1
  223. package/dist/esm/models/register-award-v1-request-dto.js +1 -1
  224. package/dist/esm/models/register-semo-contract-request-dto.d.ts +1 -1
  225. package/dist/esm/models/register-semo-contract-request-dto.js +1 -1
  226. package/dist/esm/models/request-split-invoice-v1-request-dto.d.ts +1 -1
  227. package/dist/esm/models/request-split-invoice-v1-request-dto.js +1 -1
  228. package/dist/esm/models/retiree-roster-input-dto.d.ts +1 -1
  229. package/dist/esm/models/retiree-roster-input-dto.js +1 -1
  230. package/dist/esm/models/retiree-roster-row-dto.d.ts +1 -1
  231. package/dist/esm/models/retiree-roster-row-dto.js +1 -1
  232. package/dist/esm/models/revoke-request-dto.d.ts +34 -0
  233. package/dist/esm/models/revoke-request-dto.js +17 -0
  234. package/dist/esm/models/semo-contract-registered-response-dto.d.ts +1 -1
  235. package/dist/esm/models/semo-contract-registered-response-dto.js +1 -1
  236. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +1 -1
  237. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +1 -1
  238. package/dist/esm/models/split-invoice-v1-response-dto.d.ts +1 -1
  239. package/dist/esm/models/split-invoice-v1-response-dto.js +1 -1
  240. package/dist/esm/models/statement-document-dto.d.ts +1 -1
  241. package/dist/esm/models/statement-document-dto.js +1 -1
  242. package/dist/esm/models/statement-product-dto.d.ts +1 -1
  243. package/dist/esm/models/statement-product-dto.js +1 -1
  244. package/dist/esm/models/statement-v1-document-dto.d.ts +1 -1
  245. package/dist/esm/models/statement-v1-document-dto.js +1 -1
  246. package/dist/esm/models/statement-v1-product-dto.d.ts +1 -1
  247. package/dist/esm/models/statement-v1-product-dto.js +1 -1
  248. package/dist/esm/models/submit-negotiation-scores-request-dto.d.ts +1 -1
  249. package/dist/esm/models/submit-negotiation-scores-request-dto.js +1 -1
  250. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.d.ts +1 -1
  251. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.js +1 -1
  252. package/dist/esm/models/supplier-card-payable-response-dto.d.ts +1 -1
  253. package/dist/esm/models/supplier-card-payable-response-dto.js +1 -1
  254. package/dist/esm/models/supplier-tax-type.d.ts +1 -1
  255. package/dist/esm/models/supplier-tax-type.js +1 -1
  256. package/dist/esm/models/tax-invoice-issued-response-dto.d.ts +1 -1
  257. package/dist/esm/models/tax-invoice-issued-response-dto.js +1 -1
  258. package/dist/esm/models/token-request-dto.d.ts +1 -1
  259. package/dist/esm/models/token-request-dto.js +1 -1
  260. package/dist/esm/models/token-response-dto.d.ts +1 -1
  261. package/dist/esm/models/token-response-dto.js +1 -1
  262. package/dist/esm/models/update-bid-request-dto.d.ts +1 -1
  263. package/dist/esm/models/update-bid-request-dto.js +1 -1
  264. package/dist/esm/models/upload-file-request-dto.d.ts +1 -1
  265. package/dist/esm/models/upload-file-request-dto.js +1 -1
  266. package/dist/esm/models/upload-file-v1-request-dto.d.ts +1 -1
  267. package/dist/esm/models/upload-file-v1-request-dto.js +1 -1
  268. package/dist/index.d.ts +1 -1
  269. package/dist/index.js +1 -1
  270. package/dist/models/acceptance-result-response-dto.d.ts +1 -1
  271. package/dist/models/acceptance-result-response-dto.js +1 -1
  272. package/dist/models/acceptance-result-v1-response-dto.d.ts +1 -1
  273. package/dist/models/acceptance-result-v1-response-dto.js +1 -1
  274. package/dist/models/acknowledge-products-v1-request-dto.d.ts +1 -1
  275. package/dist/models/acknowledge-products-v1-request-dto.js +1 -1
  276. package/dist/models/authorization-server-metadata-dto.d.ts +49 -0
  277. package/dist/models/authorization-server-metadata-dto.js +15 -0
  278. package/dist/models/award-method-public.d.ts +1 -1
  279. package/dist/models/award-method-public.js +1 -1
  280. package/dist/models/award-registered-response-dto.d.ts +1 -1
  281. package/dist/models/award-registered-response-dto.js +1 -1
  282. package/dist/models/award-registered-v2-response-dto.d.ts +1 -1
  283. package/dist/models/award-registered-v2-response-dto.js +1 -1
  284. package/dist/models/bid-attachment-v1-dto.d.ts +1 -1
  285. package/dist/models/bid-attachment-v1-dto.js +1 -1
  286. package/dist/models/bid-bond-dto.d.ts +1 -1
  287. package/dist/models/bid-bond-dto.js +1 -1
  288. package/dist/models/bid-bond-v1-dto.d.ts +1 -1
  289. package/dist/models/bid-bond-v1-dto.js +1 -1
  290. package/dist/models/bid-contract-documents-batch-v1-request-dto.d.ts +1 -1
  291. package/dist/models/bid-contract-documents-batch-v1-request-dto.js +1 -1
  292. package/dist/models/bid-contract-documents-v1-response-dto.d.ts +1 -1
  293. package/dist/models/bid-contract-documents-v1-response-dto.js +1 -1
  294. package/dist/models/bid-created-response-dto.d.ts +1 -1
  295. package/dist/models/bid-created-response-dto.js +1 -1
  296. package/dist/models/bid-detail-response-dto.d.ts +1 -1
  297. package/dist/models/bid-detail-response-dto.js +1 -1
  298. package/dist/models/bid-document-dto.d.ts +1 -1
  299. package/dist/models/bid-document-dto.js +1 -1
  300. package/dist/models/bid-document-v1-dto.d.ts +1 -1
  301. package/dist/models/bid-document-v1-dto.js +1 -1
  302. package/dist/models/bid-failed-response-dto.d.ts +1 -1
  303. package/dist/models/bid-failed-response-dto.js +1 -1
  304. package/dist/models/bid-failed-v2-response-dto.d.ts +1 -1
  305. package/dist/models/bid-failed-v2-response-dto.js +1 -1
  306. package/dist/models/bid-failure-reason.d.ts +1 -1
  307. package/dist/models/bid-failure-reason.js +1 -1
  308. package/dist/models/bid-item-dto.d.ts +1 -1
  309. package/dist/models/bid-item-dto.js +1 -1
  310. package/dist/models/bid-item-v1-dto.d.ts +1 -1
  311. package/dist/models/bid-item-v1-dto.js +1 -1
  312. package/dist/models/bid-lifecycle-dto.d.ts +1 -1
  313. package/dist/models/bid-lifecycle-dto.js +1 -1
  314. package/dist/models/bid-manager-dto.d.ts +1 -1
  315. package/dist/models/bid-manager-dto.js +1 -1
  316. package/dist/models/bid-manager-v1-dto.d.ts +1 -1
  317. package/dist/models/bid-manager-v1-dto.js +1 -1
  318. package/dist/models/bid-participant-summary-dto.d.ts +1 -1
  319. package/dist/models/bid-participant-summary-dto.js +1 -1
  320. package/dist/models/bid-public-status.d.ts +1 -1
  321. package/dist/models/bid-public-status.js +1 -1
  322. package/dist/models/bid-published-response-dto.d.ts +1 -1
  323. package/dist/models/bid-published-response-dto.js +1 -1
  324. package/dist/models/bid-registered-response-dto.d.ts +1 -1
  325. package/dist/models/bid-registered-response-dto.js +1 -1
  326. package/dist/models/bid-result-participant-attachment-dto.d.ts +1 -1
  327. package/dist/models/bid-result-participant-attachment-dto.js +1 -1
  328. package/dist/models/bid-result-participant-dto.d.ts +1 -1
  329. package/dist/models/bid-result-participant-dto.js +1 -1
  330. package/dist/models/bid-result-v1-attachment-dto.d.ts +1 -1
  331. package/dist/models/bid-result-v1-attachment-dto.js +1 -1
  332. package/dist/models/bid-result-v1-bid-product-info-dto.d.ts +1 -1
  333. package/dist/models/bid-result-v1-bid-product-info-dto.js +1 -1
  334. package/dist/models/bid-result-v1-participant-dto.d.ts +1 -1
  335. package/dist/models/bid-result-v1-participant-dto.js +1 -1
  336. package/dist/models/bid-result-v1-product-dto.d.ts +1 -1
  337. package/dist/models/bid-result-v1-product-dto.js +1 -1
  338. package/dist/models/bid-results-batch-v1-request-dto.d.ts +1 -1
  339. package/dist/models/bid-results-batch-v1-request-dto.js +1 -1
  340. package/dist/models/bid-results-response-dto.d.ts +1 -1
  341. package/dist/models/bid-results-response-dto.js +1 -1
  342. package/dist/models/bid-results-v1-response-dto.d.ts +1 -1
  343. package/dist/models/bid-results-v1-response-dto.js +1 -1
  344. package/dist/models/bid-settlement-line-item-dto.d.ts +1 -1
  345. package/dist/models/bid-settlement-line-item-dto.js +1 -1
  346. package/dist/models/bid-settlement-participant-dto.d.ts +1 -1
  347. package/dist/models/bid-settlement-participant-dto.js +1 -1
  348. package/dist/models/bid-settlement-response-dto.d.ts +1 -1
  349. package/dist/models/bid-settlement-response-dto.js +1 -1
  350. package/dist/models/bid-statement-response-dto.d.ts +1 -1
  351. package/dist/models/bid-statement-response-dto.js +1 -1
  352. package/dist/models/bid-statement-v1-response-dto.d.ts +1 -1
  353. package/dist/models/bid-statement-v1-response-dto.js +1 -1
  354. package/dist/models/bid-status.d.ts +1 -1
  355. package/dist/models/bid-status.js +1 -1
  356. package/dist/models/bid-summary-dto.d.ts +1 -1
  357. package/dist/models/bid-summary-dto.js +1 -1
  358. package/dist/models/bid-updated-response-dto.d.ts +1 -1
  359. package/dist/models/bid-updated-response-dto.js +1 -1
  360. package/dist/models/card-payment-request-response-dto.d.ts +1 -1
  361. package/dist/models/card-payment-request-response-dto.js +1 -1
  362. package/dist/models/close-sandbox-bid-response-dto.d.ts +1 -1
  363. package/dist/models/close-sandbox-bid-response-dto.js +1 -1
  364. package/dist/models/complete-acceptance-request-dto.d.ts +1 -1
  365. package/dist/models/complete-acceptance-request-dto.js +1 -1
  366. package/dist/models/complete-acceptance-v1-request-dto.d.ts +1 -1
  367. package/dist/models/complete-acceptance-v1-request-dto.js +1 -1
  368. package/dist/models/contract-document-item-dto.d.ts +1 -1
  369. package/dist/models/contract-document-item-dto.js +1 -1
  370. package/dist/models/contract-documents-regenerated-response-dto.d.ts +1 -1
  371. package/dist/models/contract-documents-regenerated-response-dto.js +1 -1
  372. package/dist/models/contract-restriction-confirm-input-dto.d.ts +1 -1
  373. package/dist/models/contract-restriction-confirm-input-dto.js +1 -1
  374. package/dist/models/create-bid-request-dto.d.ts +1 -1
  375. package/dist/models/create-bid-request-dto.js +1 -1
  376. package/dist/models/create-bid-v1-request-dto.d.ts +1 -1
  377. package/dist/models/create-bid-v1-request-dto.js +1 -1
  378. package/dist/models/create-card-payment-request-dto.d.ts +1 -1
  379. package/dist/models/create-card-payment-request-dto.js +1 -1
  380. package/dist/models/create-external-contract-documents-request-dto.d.ts +1 -1
  381. package/dist/models/create-external-contract-documents-request-dto.js +1 -1
  382. package/dist/models/create-external-contract-documents-response-dto.d.ts +1 -1
  383. package/dist/models/create-external-contract-documents-response-dto.js +1 -1
  384. package/dist/models/embed-launch-request-dto.d.ts +1 -1
  385. package/dist/models/embed-launch-request-dto.js +1 -1
  386. package/dist/models/embed-launch-response-dto.d.ts +1 -1
  387. package/dist/models/embed-launch-response-dto.js +1 -1
  388. package/dist/models/external-contract-document-item-dto.d.ts +1 -1
  389. package/dist/models/external-contract-document-item-dto.js +1 -1
  390. package/dist/models/external-contract-documents-response-dto.d.ts +1 -1
  391. package/dist/models/external-contract-documents-response-dto.js +1 -1
  392. package/dist/models/external-contract-item-dto.d.ts +1 -1
  393. package/dist/models/external-contract-item-dto.js +1 -1
  394. package/dist/models/external-contract-snapshot-dto.d.ts +1 -1
  395. package/dist/models/external-contract-snapshot-dto.js +1 -1
  396. package/dist/models/external-document-inputs-dto.d.ts +1 -1
  397. package/dist/models/external-document-inputs-dto.js +1 -1
  398. package/dist/models/file-uploaded-response-dto.d.ts +1 -1
  399. package/dist/models/file-uploaded-response-dto.js +1 -1
  400. package/dist/models/file-uploaded-v1-response-dto.d.ts +1 -1
  401. package/dist/models/file-uploaded-v1-response-dto.js +1 -1
  402. package/dist/models/generated-external-contract-document-dto.d.ts +1 -1
  403. package/dist/models/generated-external-contract-document-dto.js +1 -1
  404. package/dist/models/health-response-dto.d.ts +1 -1
  405. package/dist/models/health-response-dto.js +1 -1
  406. package/dist/models/hierarchical-region-dto.d.ts +1 -1
  407. package/dist/models/hierarchical-region-dto.js +1 -1
  408. package/dist/models/hierarchical-region-v1-dto.d.ts +1 -1
  409. package/dist/models/hierarchical-region-v1-dto.js +1 -1
  410. package/dist/models/index.d.ts +3 -0
  411. package/dist/models/index.js +3 -0
  412. package/dist/models/invalid-param-dto.d.ts +1 -1
  413. package/dist/models/invalid-param-dto.js +1 -1
  414. package/dist/models/invoice-completed-response-dto.d.ts +1 -1
  415. package/dist/models/invoice-completed-response-dto.js +1 -1
  416. package/dist/models/issue-tax-invoice-request-dto.d.ts +1 -1
  417. package/dist/models/issue-tax-invoice-request-dto.js +1 -1
  418. package/dist/models/list-bids-response-dto.d.ts +1 -1
  419. package/dist/models/list-bids-response-dto.js +1 -1
  420. package/dist/models/mark-bid-failed-request-dto.d.ts +1 -1
  421. package/dist/models/mark-bid-failed-request-dto.js +1 -1
  422. package/dist/models/mark-bid-failed-v1-request-dto.d.ts +1 -1
  423. package/dist/models/mark-bid-failed-v1-request-dto.js +1 -1
  424. package/dist/models/negotiation-score-dto.d.ts +1 -1
  425. package/dist/models/negotiation-score-dto.js +1 -1
  426. package/dist/models/negotiation-score-v1-dto.d.ts +1 -1
  427. package/dist/models/negotiation-score-v1-dto.js +1 -1
  428. package/dist/models/negotiation-scored-response-dto.d.ts +1 -1
  429. package/dist/models/negotiation-scored-response-dto.js +1 -1
  430. package/dist/models/negotiation-scored-v2-response-dto.d.ts +1 -1
  431. package/dist/models/negotiation-scored-v2-response-dto.js +1 -1
  432. package/dist/models/oauth-error-response-dto.d.ts +1 -1
  433. package/dist/models/oauth-error-response-dto.js +1 -1
  434. package/dist/models/preconditions-dto.d.ts +1 -1
  435. package/dist/models/preconditions-dto.js +1 -1
  436. package/dist/models/preconditions-v1-dto.d.ts +1 -1
  437. package/dist/models/preconditions-v1-dto.js +1 -1
  438. package/dist/models/problem-details-dto.d.ts +1 -1
  439. package/dist/models/problem-details-dto.js +1 -1
  440. package/dist/models/product-receipt-v1-response-dto.d.ts +1 -1
  441. package/dist/models/product-receipt-v1-response-dto.js +1 -1
  442. package/dist/models/product-v1-response-dto.d.ts +1 -1
  443. package/dist/models/product-v1-response-dto.js +1 -1
  444. package/dist/models/protected-resource-metadata-dto.d.ts +41 -0
  445. package/dist/models/protected-resource-metadata-dto.js +15 -0
  446. package/dist/models/register-award-request-dto.d.ts +1 -1
  447. package/dist/models/register-award-request-dto.js +1 -1
  448. package/dist/models/register-award-v1-request-dto.d.ts +1 -1
  449. package/dist/models/register-award-v1-request-dto.js +1 -1
  450. package/dist/models/register-semo-contract-request-dto.d.ts +1 -1
  451. package/dist/models/register-semo-contract-request-dto.js +1 -1
  452. package/dist/models/request-split-invoice-v1-request-dto.d.ts +1 -1
  453. package/dist/models/request-split-invoice-v1-request-dto.js +1 -1
  454. package/dist/models/retiree-roster-input-dto.d.ts +1 -1
  455. package/dist/models/retiree-roster-input-dto.js +1 -1
  456. package/dist/models/retiree-roster-row-dto.d.ts +1 -1
  457. package/dist/models/retiree-roster-row-dto.js +1 -1
  458. package/dist/models/revoke-request-dto.d.ts +34 -0
  459. package/dist/models/revoke-request-dto.js +20 -0
  460. package/dist/models/semo-contract-registered-response-dto.d.ts +1 -1
  461. package/dist/models/semo-contract-registered-response-dto.js +1 -1
  462. package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +1 -1
  463. package/dist/models/semo-contract-taxinvoice-status-response-dto.js +1 -1
  464. package/dist/models/split-invoice-v1-response-dto.d.ts +1 -1
  465. package/dist/models/split-invoice-v1-response-dto.js +1 -1
  466. package/dist/models/statement-document-dto.d.ts +1 -1
  467. package/dist/models/statement-document-dto.js +1 -1
  468. package/dist/models/statement-product-dto.d.ts +1 -1
  469. package/dist/models/statement-product-dto.js +1 -1
  470. package/dist/models/statement-v1-document-dto.d.ts +1 -1
  471. package/dist/models/statement-v1-document-dto.js +1 -1
  472. package/dist/models/statement-v1-product-dto.d.ts +1 -1
  473. package/dist/models/statement-v1-product-dto.js +1 -1
  474. package/dist/models/submit-negotiation-scores-request-dto.d.ts +1 -1
  475. package/dist/models/submit-negotiation-scores-request-dto.js +1 -1
  476. package/dist/models/submit-negotiation-scores-v1-request-dto.d.ts +1 -1
  477. package/dist/models/submit-negotiation-scores-v1-request-dto.js +1 -1
  478. package/dist/models/supplier-card-payable-response-dto.d.ts +1 -1
  479. package/dist/models/supplier-card-payable-response-dto.js +1 -1
  480. package/dist/models/supplier-tax-type.d.ts +1 -1
  481. package/dist/models/supplier-tax-type.js +1 -1
  482. package/dist/models/tax-invoice-issued-response-dto.d.ts +1 -1
  483. package/dist/models/tax-invoice-issued-response-dto.js +1 -1
  484. package/dist/models/token-request-dto.d.ts +1 -1
  485. package/dist/models/token-request-dto.js +1 -1
  486. package/dist/models/token-response-dto.d.ts +1 -1
  487. package/dist/models/token-response-dto.js +1 -1
  488. package/dist/models/update-bid-request-dto.d.ts +1 -1
  489. package/dist/models/update-bid-request-dto.js +1 -1
  490. package/dist/models/upload-file-request-dto.d.ts +1 -1
  491. package/dist/models/upload-file-request-dto.js +1 -1
  492. package/dist/models/upload-file-v1-request-dto.d.ts +1 -1
  493. package/dist/models/upload-file-v1-request-dto.js +1 -1
  494. package/docs/AuthorizationServerMetadataDto.md +36 -0
  495. package/docs/OauthApi.md +54 -0
  496. package/docs/ProtectedResourceMetadataDto.md +32 -0
  497. package/docs/RevokeRequestDto.md +26 -0
  498. package/docs/WellKnownApi.md +97 -0
  499. package/index.ts +1 -1
  500. package/models/acceptance-result-response-dto.ts +1 -1
  501. package/models/acceptance-result-v1-response-dto.ts +1 -1
  502. package/models/acknowledge-products-v1-request-dto.ts +1 -1
  503. package/models/authorization-server-metadata-dto.ts +55 -0
  504. package/models/award-method-public.ts +1 -1
  505. package/models/award-registered-response-dto.ts +1 -1
  506. package/models/award-registered-v2-response-dto.ts +1 -1
  507. package/models/bid-attachment-v1-dto.ts +1 -1
  508. package/models/bid-bond-dto.ts +1 -1
  509. package/models/bid-bond-v1-dto.ts +1 -1
  510. package/models/bid-contract-documents-batch-v1-request-dto.ts +1 -1
  511. package/models/bid-contract-documents-v1-response-dto.ts +1 -1
  512. package/models/bid-created-response-dto.ts +1 -1
  513. package/models/bid-detail-response-dto.ts +1 -1
  514. package/models/bid-document-dto.ts +1 -1
  515. package/models/bid-document-v1-dto.ts +1 -1
  516. package/models/bid-failed-response-dto.ts +1 -1
  517. package/models/bid-failed-v2-response-dto.ts +1 -1
  518. package/models/bid-failure-reason.ts +1 -1
  519. package/models/bid-item-dto.ts +1 -1
  520. package/models/bid-item-v1-dto.ts +1 -1
  521. package/models/bid-lifecycle-dto.ts +1 -1
  522. package/models/bid-manager-dto.ts +1 -1
  523. package/models/bid-manager-v1-dto.ts +1 -1
  524. package/models/bid-participant-summary-dto.ts +1 -1
  525. package/models/bid-public-status.ts +1 -1
  526. package/models/bid-published-response-dto.ts +1 -1
  527. package/models/bid-registered-response-dto.ts +1 -1
  528. package/models/bid-result-participant-attachment-dto.ts +1 -1
  529. package/models/bid-result-participant-dto.ts +1 -1
  530. package/models/bid-result-v1-attachment-dto.ts +1 -1
  531. package/models/bid-result-v1-bid-product-info-dto.ts +1 -1
  532. package/models/bid-result-v1-participant-dto.ts +1 -1
  533. package/models/bid-result-v1-product-dto.ts +1 -1
  534. package/models/bid-results-batch-v1-request-dto.ts +1 -1
  535. package/models/bid-results-response-dto.ts +1 -1
  536. package/models/bid-results-v1-response-dto.ts +1 -1
  537. package/models/bid-settlement-line-item-dto.ts +1 -1
  538. package/models/bid-settlement-participant-dto.ts +1 -1
  539. package/models/bid-settlement-response-dto.ts +1 -1
  540. package/models/bid-statement-response-dto.ts +1 -1
  541. package/models/bid-statement-v1-response-dto.ts +1 -1
  542. package/models/bid-status.ts +1 -1
  543. package/models/bid-summary-dto.ts +1 -1
  544. package/models/bid-updated-response-dto.ts +1 -1
  545. package/models/card-payment-request-response-dto.ts +1 -1
  546. package/models/close-sandbox-bid-response-dto.ts +1 -1
  547. package/models/complete-acceptance-request-dto.ts +1 -1
  548. package/models/complete-acceptance-v1-request-dto.ts +1 -1
  549. package/models/contract-document-item-dto.ts +1 -1
  550. package/models/contract-documents-regenerated-response-dto.ts +1 -1
  551. package/models/contract-restriction-confirm-input-dto.ts +1 -1
  552. package/models/create-bid-request-dto.ts +1 -1
  553. package/models/create-bid-v1-request-dto.ts +1 -1
  554. package/models/create-card-payment-request-dto.ts +1 -1
  555. package/models/create-external-contract-documents-request-dto.ts +1 -1
  556. package/models/create-external-contract-documents-response-dto.ts +1 -1
  557. package/models/embed-launch-request-dto.ts +1 -1
  558. package/models/embed-launch-response-dto.ts +1 -1
  559. package/models/external-contract-document-item-dto.ts +1 -1
  560. package/models/external-contract-documents-response-dto.ts +1 -1
  561. package/models/external-contract-item-dto.ts +1 -1
  562. package/models/external-contract-snapshot-dto.ts +1 -1
  563. package/models/external-document-inputs-dto.ts +1 -1
  564. package/models/file-uploaded-response-dto.ts +1 -1
  565. package/models/file-uploaded-v1-response-dto.ts +1 -1
  566. package/models/generated-external-contract-document-dto.ts +1 -1
  567. package/models/health-response-dto.ts +1 -1
  568. package/models/hierarchical-region-dto.ts +1 -1
  569. package/models/hierarchical-region-v1-dto.ts +1 -1
  570. package/models/index.ts +3 -0
  571. package/models/invalid-param-dto.ts +1 -1
  572. package/models/invoice-completed-response-dto.ts +1 -1
  573. package/models/issue-tax-invoice-request-dto.ts +1 -1
  574. package/models/list-bids-response-dto.ts +1 -1
  575. package/models/mark-bid-failed-request-dto.ts +1 -1
  576. package/models/mark-bid-failed-v1-request-dto.ts +1 -1
  577. package/models/negotiation-score-dto.ts +1 -1
  578. package/models/negotiation-score-v1-dto.ts +1 -1
  579. package/models/negotiation-scored-response-dto.ts +1 -1
  580. package/models/negotiation-scored-v2-response-dto.ts +1 -1
  581. package/models/oauth-error-response-dto.ts +1 -1
  582. package/models/preconditions-dto.ts +1 -1
  583. package/models/preconditions-v1-dto.ts +1 -1
  584. package/models/problem-details-dto.ts +1 -1
  585. package/models/product-receipt-v1-response-dto.ts +1 -1
  586. package/models/product-v1-response-dto.ts +1 -1
  587. package/models/protected-resource-metadata-dto.ts +47 -0
  588. package/models/register-award-request-dto.ts +1 -1
  589. package/models/register-award-v1-request-dto.ts +1 -1
  590. package/models/register-semo-contract-request-dto.ts +1 -1
  591. package/models/request-split-invoice-v1-request-dto.ts +1 -1
  592. package/models/retiree-roster-input-dto.ts +1 -1
  593. package/models/retiree-roster-row-dto.ts +1 -1
  594. package/models/revoke-request-dto.ts +43 -0
  595. package/models/semo-contract-registered-response-dto.ts +1 -1
  596. package/models/semo-contract-taxinvoice-status-response-dto.ts +1 -1
  597. package/models/split-invoice-v1-response-dto.ts +1 -1
  598. package/models/statement-document-dto.ts +1 -1
  599. package/models/statement-product-dto.ts +1 -1
  600. package/models/statement-v1-document-dto.ts +1 -1
  601. package/models/statement-v1-product-dto.ts +1 -1
  602. package/models/submit-negotiation-scores-request-dto.ts +1 -1
  603. package/models/submit-negotiation-scores-v1-request-dto.ts +1 -1
  604. package/models/supplier-card-payable-response-dto.ts +1 -1
  605. package/models/supplier-tax-type.ts +1 -1
  606. package/models/tax-invoice-issued-response-dto.ts +1 -1
  607. package/models/token-request-dto.ts +1 -1
  608. package/models/token-response-dto.ts +1 -1
  609. package/models/update-bid-request-dto.ts +1 -1
  610. package/models/upload-file-request-dto.ts +1 -1
  611. package/models/upload-file-v1-request-dto.ts +1 -1
  612. package/package.json +1 -1
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.8.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).
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.8.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.8.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).
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.8.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.8.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).
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.8.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.8.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).
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.8.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.8.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).
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.8.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.8.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).
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.8.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.8.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).
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.8.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.8.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).
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.8.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.8.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).
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.8.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).
@@ -0,0 +1,36 @@
1
+ # AuthorizationServerMetadataDto
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **issuer** | **string** | 이 authorization server 의 issuer identifier. 발급 토큰의 &#x60;iss&#x60; 와 같은 값이며, 클라이언트는 이 값으로 본 문서의 URL 을 만들어 대조한다(RFC 8414 §3.3). | [default to undefined]
9
+ **token_endpoint** | **string** | access token 발급 endpoint (RFC 6749 §3.2). | [default to undefined]
10
+ **revocation_endpoint** | **string** | RFC 7009 토큰 폐기 endpoint. 유출된 토큰을 TTL 만료 전에 끊는 경로. | [default to undefined]
11
+ **grant_types_supported** | **Array&lt;string&gt;** | 지원 grant type. 이 AS 는 서버-투-서버 연동만 다루므로 client_credentials 뿐이다. | [default to undefined]
12
+ **token_endpoint_auth_methods_supported** | **Array&lt;string&gt;** | token endpoint 의 client 인증 방식 (RFC 6749 §2.3.1). | [default to undefined]
13
+ **scopes_supported** | **Array&lt;string&gt;** | 발급 가능한 scope 전체. 키에 실제로 부여된 범위는 이보다 좁을 수 있다. | [default to undefined]
14
+ **response_types_supported** | **Array&lt;string&gt;** | RFC 8414 §2 필수 필드. authorization endpoint 를 쓰는 흐름이 없으므로 항상 빈 배열이다. | [default to undefined]
15
+ **dpop_signing_alg_values_supported** | **Array&lt;string&gt;** | DPoP proof 서명에 받아 주는 알고리즘 (RFC 9449 §5.1). | [default to undefined]
16
+ **service_documentation** | **string** | 사람이 읽는 API 문서 위치. | [default to undefined]
17
+
18
+ ## Example
19
+
20
+ ```typescript
21
+ import { AuthorizationServerMetadataDto } from '@cmarket/partner-sdk';
22
+
23
+ const instance: AuthorizationServerMetadataDto = {
24
+ issuer,
25
+ token_endpoint,
26
+ revocation_endpoint,
27
+ grant_types_supported,
28
+ token_endpoint_auth_methods_supported,
29
+ scopes_supported,
30
+ response_types_supported,
31
+ dpop_signing_alg_values_supported,
32
+ service_documentation,
33
+ };
34
+ ```
35
+
36
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
package/docs/OauthApi.md CHANGED
@@ -4,8 +4,62 @@ All URIs are relative to *https://partner-api.c-market.net*
4
4
 
5
5
  |Method | HTTP request | Description|
6
6
  |------------- | ------------- | -------------|
7
+ |[**revoke**](#revoke) | **POST** /oauth/revoke | OAuth 2.0 토큰 폐기 (Token Revocation, RFC 7009)|
7
8
  |[**token**](#token) | **POST** /oauth/token | OAuth 2.0 access token 발급 (client_credentials)|
8
9
 
10
+ # **revoke**
11
+ > revoke(revokeRequestDto)
12
+
13
+ 발급받은 access token 을 즉시 무효화합니다. 유출을 확인했을 때 TTL(15분) 만료를 기다리지 않고 끊는 경로입니다. RFC 7009 §2.2 에 따라 이미 만료됐거나 알 수 없는 토큰을 보내도 200 으로 응답합니다.
14
+
15
+ ### Example
16
+
17
+ ```typescript
18
+ import {
19
+ OauthApi,
20
+ Configuration,
21
+ RevokeRequestDto
22
+ } from '@cmarket/partner-sdk';
23
+
24
+ const configuration = new Configuration();
25
+ const apiInstance = new OauthApi(configuration);
26
+
27
+ let revokeRequestDto: RevokeRequestDto; //
28
+
29
+ const { status, data } = await apiInstance.revoke(
30
+ revokeRequestDto
31
+ );
32
+ ```
33
+
34
+ ### Parameters
35
+
36
+ |Name | Type | Description | Notes|
37
+ |------------- | ------------- | ------------- | -------------|
38
+ | **revokeRequestDto** | **RevokeRequestDto**| | |
39
+
40
+
41
+ ### Return type
42
+
43
+ void (empty response body)
44
+
45
+ ### Authorization
46
+
47
+ No authorization required
48
+
49
+ ### HTTP request headers
50
+
51
+ - **Content-Type**: application/json
52
+ - **Accept**: application/json
53
+
54
+
55
+ ### HTTP response details
56
+ | Status code | Description | Response headers |
57
+ |-------------|-------------|------------------|
58
+ |**200** | 폐기 요청이 처리되었습니다(본문 없음). | - |
59
+ |**401** | RFC 6749 §5.2 오류 envelope — client 인증 실패(&#x60;error: invalid_client&#x60;). | - |
60
+
61
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
62
+
9
63
  # **token**
10
64
  > TokenResponseDto token(tokenRequestDto)
11
65
 
@@ -0,0 +1,32 @@
1
+ # ProtectedResourceMetadataDto
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **resource** | **string** | 이 보호 자원의 식별자(&#x3D;이 API 의 origin). RFC 9728 §2 필수. | [default to undefined]
9
+ **authorization_servers** | **Array&lt;string&gt;** | 이 자원의 토큰을 발급할 수 있는 authorization server 의 issuer 목록. 클라이언트는 401 을 받으면 여기서 토큰을 받는다. | [default to undefined]
10
+ **scopes_supported** | **Array&lt;string&gt;** | 이 자원이 이해하는 scope 전체. | [default to undefined]
11
+ **bearer_methods_supported** | **Array&lt;string&gt;** | access token 전달 방식 (RFC 6750). &#x60;header&#x60; 만 받는다 — 쿼리스트링·본문 전달은 접근 로그·리퍼러로 토큰이 새는 경로다. | [default to undefined]
12
+ **dpop_signing_alg_values_supported** | **Array&lt;string&gt;** | DPoP proof 서명에 받아 주는 알고리즘 (RFC 9449 §5.1). | [default to undefined]
13
+ **dpop_bound_access_tokens_required** | **boolean** | DPoP 바인딩 토큰을 **전역으로** 강제하는지. false — DPoP 는 키 단위 설정이라 파트너마다 다르다. true 로 광고하면 DPoP 를 쓰지 않는 정상 키의 클라이언트가 스스로 실패한다. | [default to undefined]
14
+ **resource_documentation** | **string** | 사람이 읽는 API 문서 위치. | [default to undefined]
15
+
16
+ ## Example
17
+
18
+ ```typescript
19
+ import { ProtectedResourceMetadataDto } from '@cmarket/partner-sdk';
20
+
21
+ const instance: ProtectedResourceMetadataDto = {
22
+ resource,
23
+ authorization_servers,
24
+ scopes_supported,
25
+ bearer_methods_supported,
26
+ dpop_signing_alg_values_supported,
27
+ dpop_bound_access_tokens_required,
28
+ resource_documentation,
29
+ };
30
+ ```
31
+
32
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,26 @@
1
+ # RevokeRequestDto
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **token** | **string** | 폐기할 토큰. 이 API 는 access token 만 발급하므로 access token 을 넣습니다. | [default to undefined]
9
+ **token_type_hint** | **string** | 토큰 종류 힌트. 이 API 는 access_token 만 발급하므로 무시됩니다. | [optional] [default to undefined]
10
+ **client_id** | **string** | client_id (Basic 인증 헤더를 쓰지 않는 경우) | [optional] [default to undefined]
11
+ **client_secret** | **string** | client_secret (Basic 인증 헤더를 쓰지 않는 경우) | [optional] [default to undefined]
12
+
13
+ ## Example
14
+
15
+ ```typescript
16
+ import { RevokeRequestDto } from '@cmarket/partner-sdk';
17
+
18
+ const instance: RevokeRequestDto = {
19
+ token,
20
+ token_type_hint,
21
+ client_id,
22
+ client_secret,
23
+ };
24
+ ```
25
+
26
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,97 @@
1
+ # WellKnownApi
2
+
3
+ All URIs are relative to *https://partner-api.c-market.net*
4
+
5
+ |Method | HTTP request | Description|
6
+ |------------- | ------------- | -------------|
7
+ |[**authorizationServerMetadata**](#authorizationservermetadata) | **GET** /.well-known/oauth-authorization-server | OAuth 2.0 인가서버 메타데이터 (Authorization Server Metadata, RFC 8414)|
8
+ |[**protectedResourceMetadata**](#protectedresourcemetadata) | **GET** /.well-known/oauth-protected-resource | OAuth 2.0 보호자원 메타데이터 (Protected Resource Metadata, RFC 9728)|
9
+
10
+ # **authorizationServerMetadata**
11
+ > AuthorizationServerMetadataDto authorizationServerMetadata()
12
+
13
+ 이 배포의 token endpoint·지원 grant/scope/알고리즘을 기계가 읽는 형식으로 공개합니다. 인증이 필요 없습니다.
14
+
15
+ ### Example
16
+
17
+ ```typescript
18
+ import {
19
+ WellKnownApi,
20
+ Configuration
21
+ } from '@cmarket/partner-sdk';
22
+
23
+ const configuration = new Configuration();
24
+ const apiInstance = new WellKnownApi(configuration);
25
+
26
+ const { status, data } = await apiInstance.authorizationServerMetadata();
27
+ ```
28
+
29
+ ### Parameters
30
+ This endpoint does not have any parameters.
31
+
32
+
33
+ ### Return type
34
+
35
+ **AuthorizationServerMetadataDto**
36
+
37
+ ### Authorization
38
+
39
+ No authorization required
40
+
41
+ ### HTTP request headers
42
+
43
+ - **Content-Type**: Not defined
44
+ - **Accept**: application/json
45
+
46
+
47
+ ### HTTP response details
48
+ | Status code | Description | Response headers |
49
+ |-------------|-------------|------------------|
50
+ |**200** | | - |
51
+
52
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
53
+
54
+ # **protectedResourceMetadata**
55
+ > ProtectedResourceMetadataDto protectedResourceMetadata()
56
+
57
+ 이 API 를 보호하는 authorization server 와 지원 scope 를 공개합니다. 401 응답의 WWW-Authenticate 헤더가 이 문서를 가리킵니다. 인증이 필요 없습니다.
58
+
59
+ ### Example
60
+
61
+ ```typescript
62
+ import {
63
+ WellKnownApi,
64
+ Configuration
65
+ } from '@cmarket/partner-sdk';
66
+
67
+ const configuration = new Configuration();
68
+ const apiInstance = new WellKnownApi(configuration);
69
+
70
+ const { status, data } = await apiInstance.protectedResourceMetadata();
71
+ ```
72
+
73
+ ### Parameters
74
+ This endpoint does not have any parameters.
75
+
76
+
77
+ ### Return type
78
+
79
+ **ProtectedResourceMetadataDto**
80
+
81
+ ### Authorization
82
+
83
+ No authorization required
84
+
85
+ ### HTTP request headers
86
+
87
+ - **Content-Type**: Not defined
88
+ - **Accept**: application/json
89
+
90
+
91
+ ### HTTP response details
92
+ | Status code | Description | Response headers |
93
+ |-------------|-------------|------------------|
94
+ |**200** | | - |
95
+
96
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
97
+
package/index.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * CMARKET V6 Partner API
5
5
  * 외부 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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
6
  *
7
- * The version of the OpenAPI document: 22.6.0
7
+ * The version of the OpenAPI document: 22.8.0
8
8
  * Contact: semo.io.kr@gmail.com
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -4,7 +4,7 @@
4
4
  * CMARKET V6 Partner API
5
5
  * 외부 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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
6
  *
7
- * The version of the OpenAPI document: 22.6.0
7
+ * The version of the OpenAPI document: 22.8.0
8
8
  * Contact: semo.io.kr@gmail.com
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -4,7 +4,7 @@
4
4
  * CMARKET V6 Partner API
5
5
  * 외부 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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
6
  *
7
- * The version of the OpenAPI document: 22.6.0
7
+ * The version of the OpenAPI document: 22.8.0
8
8
  * Contact: semo.io.kr@gmail.com
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -4,7 +4,7 @@
4
4
  * CMARKET V6 Partner API
5
5
  * 외부 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 이다. 대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것. ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `correlationId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 동일 — 문의 시 이 값을 첨부. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음). ## 레이트 리밋 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). `Retry-After` 헤더가 재시도 대기(초)를, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헤더가 현재 쿼터를 안내한다. 대량 동기화(품목 단위 반복 등록 등)는 429 를 만나면 `Retry-After` 만큼 backoff 후 재시도할 것. ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다. ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시다. 이후 `Deprecation`/`Sunset` 응답 헤더로 폐지 일정을 사전 통지한다. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
6
6
  *
7
- * The version of the OpenAPI document: 22.6.0
7
+ * The version of the OpenAPI document: 22.8.0
8
8
  * Contact: semo.io.kr@gmail.com
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).