@cmarket/partner-sdk 22.5.0 β†’ 22.7.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 (609) hide show
  1. package/README.md +13 -4
  2. package/api/oauth-api.ts +1 -1
  3. package/api/partner-v1-api.ts +1 -1
  4. package/api/partner-v2-api.ts +161 -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 +1 -1
  11. package/dist/api/oauth-api.js +1 -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 +72 -1
  15. package/dist/api/partner-v2-api.js +149 -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 +1 -1
  27. package/dist/esm/api/oauth-api.js +1 -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 +72 -1
  31. package/dist/esm/api/partner-v2-api.js +149 -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 +45 -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 +5 -0
  185. package/dist/esm/models/index.js +5 -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 +62 -0
  225. package/dist/esm/models/register-semo-contract-request-dto.js +17 -0
  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/semo-contract-registered-response-dto.d.ts +25 -0
  233. package/dist/esm/models/semo-contract-registered-response-dto.js +14 -0
  234. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +43 -0
  235. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +18 -0
  236. package/dist/esm/models/split-invoice-v1-response-dto.d.ts +1 -1
  237. package/dist/esm/models/split-invoice-v1-response-dto.js +1 -1
  238. package/dist/esm/models/statement-document-dto.d.ts +1 -1
  239. package/dist/esm/models/statement-document-dto.js +1 -1
  240. package/dist/esm/models/statement-product-dto.d.ts +1 -1
  241. package/dist/esm/models/statement-product-dto.js +1 -1
  242. package/dist/esm/models/statement-v1-document-dto.d.ts +1 -1
  243. package/dist/esm/models/statement-v1-document-dto.js +1 -1
  244. package/dist/esm/models/statement-v1-product-dto.d.ts +1 -1
  245. package/dist/esm/models/statement-v1-product-dto.js +1 -1
  246. package/dist/esm/models/submit-negotiation-scores-request-dto.d.ts +1 -1
  247. package/dist/esm/models/submit-negotiation-scores-request-dto.js +1 -1
  248. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.d.ts +1 -1
  249. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.js +1 -1
  250. package/dist/esm/models/supplier-card-payable-response-dto.d.ts +1 -1
  251. package/dist/esm/models/supplier-card-payable-response-dto.js +1 -1
  252. package/dist/esm/models/supplier-tax-type.d.ts +1 -1
  253. package/dist/esm/models/supplier-tax-type.js +1 -1
  254. package/dist/esm/models/tax-invoice-issued-response-dto.d.ts +1 -1
  255. package/dist/esm/models/tax-invoice-issued-response-dto.js +1 -1
  256. package/dist/esm/models/token-request-dto.d.ts +1 -1
  257. package/dist/esm/models/token-request-dto.js +1 -1
  258. package/dist/esm/models/token-response-dto.d.ts +1 -1
  259. package/dist/esm/models/token-response-dto.js +1 -1
  260. package/dist/esm/models/update-bid-request-dto.d.ts +1 -1
  261. package/dist/esm/models/update-bid-request-dto.js +1 -1
  262. package/dist/esm/models/upload-file-request-dto.d.ts +1 -1
  263. package/dist/esm/models/upload-file-request-dto.js +1 -1
  264. package/dist/esm/models/upload-file-v1-request-dto.d.ts +1 -1
  265. package/dist/esm/models/upload-file-v1-request-dto.js +1 -1
  266. package/dist/index.d.ts +1 -1
  267. package/dist/index.js +1 -1
  268. package/dist/models/acceptance-result-response-dto.d.ts +1 -1
  269. package/dist/models/acceptance-result-response-dto.js +1 -1
  270. package/dist/models/acceptance-result-v1-response-dto.d.ts +1 -1
  271. package/dist/models/acceptance-result-v1-response-dto.js +1 -1
  272. package/dist/models/acknowledge-products-v1-request-dto.d.ts +1 -1
  273. package/dist/models/acknowledge-products-v1-request-dto.js +1 -1
  274. package/dist/models/authorization-server-metadata-dto.d.ts +45 -0
  275. package/dist/models/authorization-server-metadata-dto.js +15 -0
  276. package/dist/models/award-method-public.d.ts +1 -1
  277. package/dist/models/award-method-public.js +1 -1
  278. package/dist/models/award-registered-response-dto.d.ts +1 -1
  279. package/dist/models/award-registered-response-dto.js +1 -1
  280. package/dist/models/award-registered-v2-response-dto.d.ts +1 -1
  281. package/dist/models/award-registered-v2-response-dto.js +1 -1
  282. package/dist/models/bid-attachment-v1-dto.d.ts +1 -1
  283. package/dist/models/bid-attachment-v1-dto.js +1 -1
  284. package/dist/models/bid-bond-dto.d.ts +1 -1
  285. package/dist/models/bid-bond-dto.js +1 -1
  286. package/dist/models/bid-bond-v1-dto.d.ts +1 -1
  287. package/dist/models/bid-bond-v1-dto.js +1 -1
  288. package/dist/models/bid-contract-documents-batch-v1-request-dto.d.ts +1 -1
  289. package/dist/models/bid-contract-documents-batch-v1-request-dto.js +1 -1
  290. package/dist/models/bid-contract-documents-v1-response-dto.d.ts +1 -1
  291. package/dist/models/bid-contract-documents-v1-response-dto.js +1 -1
  292. package/dist/models/bid-created-response-dto.d.ts +1 -1
  293. package/dist/models/bid-created-response-dto.js +1 -1
  294. package/dist/models/bid-detail-response-dto.d.ts +1 -1
  295. package/dist/models/bid-detail-response-dto.js +1 -1
  296. package/dist/models/bid-document-dto.d.ts +1 -1
  297. package/dist/models/bid-document-dto.js +1 -1
  298. package/dist/models/bid-document-v1-dto.d.ts +1 -1
  299. package/dist/models/bid-document-v1-dto.js +1 -1
  300. package/dist/models/bid-failed-response-dto.d.ts +1 -1
  301. package/dist/models/bid-failed-response-dto.js +1 -1
  302. package/dist/models/bid-failed-v2-response-dto.d.ts +1 -1
  303. package/dist/models/bid-failed-v2-response-dto.js +1 -1
  304. package/dist/models/bid-failure-reason.d.ts +1 -1
  305. package/dist/models/bid-failure-reason.js +1 -1
  306. package/dist/models/bid-item-dto.d.ts +1 -1
  307. package/dist/models/bid-item-dto.js +1 -1
  308. package/dist/models/bid-item-v1-dto.d.ts +1 -1
  309. package/dist/models/bid-item-v1-dto.js +1 -1
  310. package/dist/models/bid-lifecycle-dto.d.ts +1 -1
  311. package/dist/models/bid-lifecycle-dto.js +1 -1
  312. package/dist/models/bid-manager-dto.d.ts +1 -1
  313. package/dist/models/bid-manager-dto.js +1 -1
  314. package/dist/models/bid-manager-v1-dto.d.ts +1 -1
  315. package/dist/models/bid-manager-v1-dto.js +1 -1
  316. package/dist/models/bid-participant-summary-dto.d.ts +1 -1
  317. package/dist/models/bid-participant-summary-dto.js +1 -1
  318. package/dist/models/bid-public-status.d.ts +1 -1
  319. package/dist/models/bid-public-status.js +1 -1
  320. package/dist/models/bid-published-response-dto.d.ts +1 -1
  321. package/dist/models/bid-published-response-dto.js +1 -1
  322. package/dist/models/bid-registered-response-dto.d.ts +1 -1
  323. package/dist/models/bid-registered-response-dto.js +1 -1
  324. package/dist/models/bid-result-participant-attachment-dto.d.ts +1 -1
  325. package/dist/models/bid-result-participant-attachment-dto.js +1 -1
  326. package/dist/models/bid-result-participant-dto.d.ts +1 -1
  327. package/dist/models/bid-result-participant-dto.js +1 -1
  328. package/dist/models/bid-result-v1-attachment-dto.d.ts +1 -1
  329. package/dist/models/bid-result-v1-attachment-dto.js +1 -1
  330. package/dist/models/bid-result-v1-bid-product-info-dto.d.ts +1 -1
  331. package/dist/models/bid-result-v1-bid-product-info-dto.js +1 -1
  332. package/dist/models/bid-result-v1-participant-dto.d.ts +1 -1
  333. package/dist/models/bid-result-v1-participant-dto.js +1 -1
  334. package/dist/models/bid-result-v1-product-dto.d.ts +1 -1
  335. package/dist/models/bid-result-v1-product-dto.js +1 -1
  336. package/dist/models/bid-results-batch-v1-request-dto.d.ts +1 -1
  337. package/dist/models/bid-results-batch-v1-request-dto.js +1 -1
  338. package/dist/models/bid-results-response-dto.d.ts +1 -1
  339. package/dist/models/bid-results-response-dto.js +1 -1
  340. package/dist/models/bid-results-v1-response-dto.d.ts +1 -1
  341. package/dist/models/bid-results-v1-response-dto.js +1 -1
  342. package/dist/models/bid-settlement-line-item-dto.d.ts +1 -1
  343. package/dist/models/bid-settlement-line-item-dto.js +1 -1
  344. package/dist/models/bid-settlement-participant-dto.d.ts +1 -1
  345. package/dist/models/bid-settlement-participant-dto.js +1 -1
  346. package/dist/models/bid-settlement-response-dto.d.ts +1 -1
  347. package/dist/models/bid-settlement-response-dto.js +1 -1
  348. package/dist/models/bid-statement-response-dto.d.ts +1 -1
  349. package/dist/models/bid-statement-response-dto.js +1 -1
  350. package/dist/models/bid-statement-v1-response-dto.d.ts +1 -1
  351. package/dist/models/bid-statement-v1-response-dto.js +1 -1
  352. package/dist/models/bid-status.d.ts +1 -1
  353. package/dist/models/bid-status.js +1 -1
  354. package/dist/models/bid-summary-dto.d.ts +1 -1
  355. package/dist/models/bid-summary-dto.js +1 -1
  356. package/dist/models/bid-updated-response-dto.d.ts +1 -1
  357. package/dist/models/bid-updated-response-dto.js +1 -1
  358. package/dist/models/card-payment-request-response-dto.d.ts +1 -1
  359. package/dist/models/card-payment-request-response-dto.js +1 -1
  360. package/dist/models/close-sandbox-bid-response-dto.d.ts +1 -1
  361. package/dist/models/close-sandbox-bid-response-dto.js +1 -1
  362. package/dist/models/complete-acceptance-request-dto.d.ts +1 -1
  363. package/dist/models/complete-acceptance-request-dto.js +1 -1
  364. package/dist/models/complete-acceptance-v1-request-dto.d.ts +1 -1
  365. package/dist/models/complete-acceptance-v1-request-dto.js +1 -1
  366. package/dist/models/contract-document-item-dto.d.ts +1 -1
  367. package/dist/models/contract-document-item-dto.js +1 -1
  368. package/dist/models/contract-documents-regenerated-response-dto.d.ts +1 -1
  369. package/dist/models/contract-documents-regenerated-response-dto.js +1 -1
  370. package/dist/models/contract-restriction-confirm-input-dto.d.ts +1 -1
  371. package/dist/models/contract-restriction-confirm-input-dto.js +1 -1
  372. package/dist/models/create-bid-request-dto.d.ts +1 -1
  373. package/dist/models/create-bid-request-dto.js +1 -1
  374. package/dist/models/create-bid-v1-request-dto.d.ts +1 -1
  375. package/dist/models/create-bid-v1-request-dto.js +1 -1
  376. package/dist/models/create-card-payment-request-dto.d.ts +1 -1
  377. package/dist/models/create-card-payment-request-dto.js +1 -1
  378. package/dist/models/create-external-contract-documents-request-dto.d.ts +1 -1
  379. package/dist/models/create-external-contract-documents-request-dto.js +1 -1
  380. package/dist/models/create-external-contract-documents-response-dto.d.ts +1 -1
  381. package/dist/models/create-external-contract-documents-response-dto.js +1 -1
  382. package/dist/models/embed-launch-request-dto.d.ts +1 -1
  383. package/dist/models/embed-launch-request-dto.js +1 -1
  384. package/dist/models/embed-launch-response-dto.d.ts +1 -1
  385. package/dist/models/embed-launch-response-dto.js +1 -1
  386. package/dist/models/external-contract-document-item-dto.d.ts +1 -1
  387. package/dist/models/external-contract-document-item-dto.js +1 -1
  388. package/dist/models/external-contract-documents-response-dto.d.ts +1 -1
  389. package/dist/models/external-contract-documents-response-dto.js +1 -1
  390. package/dist/models/external-contract-item-dto.d.ts +1 -1
  391. package/dist/models/external-contract-item-dto.js +1 -1
  392. package/dist/models/external-contract-snapshot-dto.d.ts +1 -1
  393. package/dist/models/external-contract-snapshot-dto.js +1 -1
  394. package/dist/models/external-document-inputs-dto.d.ts +1 -1
  395. package/dist/models/external-document-inputs-dto.js +1 -1
  396. package/dist/models/file-uploaded-response-dto.d.ts +1 -1
  397. package/dist/models/file-uploaded-response-dto.js +1 -1
  398. package/dist/models/file-uploaded-v1-response-dto.d.ts +1 -1
  399. package/dist/models/file-uploaded-v1-response-dto.js +1 -1
  400. package/dist/models/generated-external-contract-document-dto.d.ts +1 -1
  401. package/dist/models/generated-external-contract-document-dto.js +1 -1
  402. package/dist/models/health-response-dto.d.ts +1 -1
  403. package/dist/models/health-response-dto.js +1 -1
  404. package/dist/models/hierarchical-region-dto.d.ts +1 -1
  405. package/dist/models/hierarchical-region-dto.js +1 -1
  406. package/dist/models/hierarchical-region-v1-dto.d.ts +1 -1
  407. package/dist/models/hierarchical-region-v1-dto.js +1 -1
  408. package/dist/models/index.d.ts +5 -0
  409. package/dist/models/index.js +5 -0
  410. package/dist/models/invalid-param-dto.d.ts +1 -1
  411. package/dist/models/invalid-param-dto.js +1 -1
  412. package/dist/models/invoice-completed-response-dto.d.ts +1 -1
  413. package/dist/models/invoice-completed-response-dto.js +1 -1
  414. package/dist/models/issue-tax-invoice-request-dto.d.ts +1 -1
  415. package/dist/models/issue-tax-invoice-request-dto.js +1 -1
  416. package/dist/models/list-bids-response-dto.d.ts +1 -1
  417. package/dist/models/list-bids-response-dto.js +1 -1
  418. package/dist/models/mark-bid-failed-request-dto.d.ts +1 -1
  419. package/dist/models/mark-bid-failed-request-dto.js +1 -1
  420. package/dist/models/mark-bid-failed-v1-request-dto.d.ts +1 -1
  421. package/dist/models/mark-bid-failed-v1-request-dto.js +1 -1
  422. package/dist/models/negotiation-score-dto.d.ts +1 -1
  423. package/dist/models/negotiation-score-dto.js +1 -1
  424. package/dist/models/negotiation-score-v1-dto.d.ts +1 -1
  425. package/dist/models/negotiation-score-v1-dto.js +1 -1
  426. package/dist/models/negotiation-scored-response-dto.d.ts +1 -1
  427. package/dist/models/negotiation-scored-response-dto.js +1 -1
  428. package/dist/models/negotiation-scored-v2-response-dto.d.ts +1 -1
  429. package/dist/models/negotiation-scored-v2-response-dto.js +1 -1
  430. package/dist/models/oauth-error-response-dto.d.ts +1 -1
  431. package/dist/models/oauth-error-response-dto.js +1 -1
  432. package/dist/models/preconditions-dto.d.ts +1 -1
  433. package/dist/models/preconditions-dto.js +1 -1
  434. package/dist/models/preconditions-v1-dto.d.ts +1 -1
  435. package/dist/models/preconditions-v1-dto.js +1 -1
  436. package/dist/models/problem-details-dto.d.ts +1 -1
  437. package/dist/models/problem-details-dto.js +1 -1
  438. package/dist/models/product-receipt-v1-response-dto.d.ts +1 -1
  439. package/dist/models/product-receipt-v1-response-dto.js +1 -1
  440. package/dist/models/product-v1-response-dto.d.ts +1 -1
  441. package/dist/models/product-v1-response-dto.js +1 -1
  442. package/dist/models/protected-resource-metadata-dto.d.ts +41 -0
  443. package/dist/models/protected-resource-metadata-dto.js +15 -0
  444. package/dist/models/register-award-request-dto.d.ts +1 -1
  445. package/dist/models/register-award-request-dto.js +1 -1
  446. package/dist/models/register-award-v1-request-dto.d.ts +1 -1
  447. package/dist/models/register-award-v1-request-dto.js +1 -1
  448. package/dist/models/register-semo-contract-request-dto.d.ts +62 -0
  449. package/dist/models/register-semo-contract-request-dto.js +20 -0
  450. package/dist/models/request-split-invoice-v1-request-dto.d.ts +1 -1
  451. package/dist/models/request-split-invoice-v1-request-dto.js +1 -1
  452. package/dist/models/retiree-roster-input-dto.d.ts +1 -1
  453. package/dist/models/retiree-roster-input-dto.js +1 -1
  454. package/dist/models/retiree-roster-row-dto.d.ts +1 -1
  455. package/dist/models/retiree-roster-row-dto.js +1 -1
  456. package/dist/models/semo-contract-registered-response-dto.d.ts +25 -0
  457. package/dist/models/semo-contract-registered-response-dto.js +15 -0
  458. package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +43 -0
  459. package/dist/models/semo-contract-taxinvoice-status-response-dto.js +21 -0
  460. package/dist/models/split-invoice-v1-response-dto.d.ts +1 -1
  461. package/dist/models/split-invoice-v1-response-dto.js +1 -1
  462. package/dist/models/statement-document-dto.d.ts +1 -1
  463. package/dist/models/statement-document-dto.js +1 -1
  464. package/dist/models/statement-product-dto.d.ts +1 -1
  465. package/dist/models/statement-product-dto.js +1 -1
  466. package/dist/models/statement-v1-document-dto.d.ts +1 -1
  467. package/dist/models/statement-v1-document-dto.js +1 -1
  468. package/dist/models/statement-v1-product-dto.d.ts +1 -1
  469. package/dist/models/statement-v1-product-dto.js +1 -1
  470. package/dist/models/submit-negotiation-scores-request-dto.d.ts +1 -1
  471. package/dist/models/submit-negotiation-scores-request-dto.js +1 -1
  472. package/dist/models/submit-negotiation-scores-v1-request-dto.d.ts +1 -1
  473. package/dist/models/submit-negotiation-scores-v1-request-dto.js +1 -1
  474. package/dist/models/supplier-card-payable-response-dto.d.ts +1 -1
  475. package/dist/models/supplier-card-payable-response-dto.js +1 -1
  476. package/dist/models/supplier-tax-type.d.ts +1 -1
  477. package/dist/models/supplier-tax-type.js +1 -1
  478. package/dist/models/tax-invoice-issued-response-dto.d.ts +1 -1
  479. package/dist/models/tax-invoice-issued-response-dto.js +1 -1
  480. package/dist/models/token-request-dto.d.ts +1 -1
  481. package/dist/models/token-request-dto.js +1 -1
  482. package/dist/models/token-response-dto.d.ts +1 -1
  483. package/dist/models/token-response-dto.js +1 -1
  484. package/dist/models/update-bid-request-dto.d.ts +1 -1
  485. package/dist/models/update-bid-request-dto.js +1 -1
  486. package/dist/models/upload-file-request-dto.d.ts +1 -1
  487. package/dist/models/upload-file-request-dto.js +1 -1
  488. package/dist/models/upload-file-v1-request-dto.d.ts +1 -1
  489. package/dist/models/upload-file-v1-request-dto.js +1 -1
  490. package/docs/AuthorizationServerMetadataDto.md +34 -0
  491. package/docs/PartnerV2Api.md +116 -0
  492. package/docs/ProtectedResourceMetadataDto.md +32 -0
  493. package/docs/RegisterSemoContractRequestDto.md +40 -0
  494. package/docs/SemoContractRegisteredResponseDto.md +24 -0
  495. package/docs/SemoContractTaxinvoiceStatusResponseDto.md +30 -0
  496. package/docs/WellKnownApi.md +97 -0
  497. package/index.ts +1 -1
  498. package/models/acceptance-result-response-dto.ts +1 -1
  499. package/models/acceptance-result-v1-response-dto.ts +1 -1
  500. package/models/acknowledge-products-v1-request-dto.ts +1 -1
  501. package/models/authorization-server-metadata-dto.ts +51 -0
  502. package/models/award-method-public.ts +1 -1
  503. package/models/award-registered-response-dto.ts +1 -1
  504. package/models/award-registered-v2-response-dto.ts +1 -1
  505. package/models/bid-attachment-v1-dto.ts +1 -1
  506. package/models/bid-bond-dto.ts +1 -1
  507. package/models/bid-bond-v1-dto.ts +1 -1
  508. package/models/bid-contract-documents-batch-v1-request-dto.ts +1 -1
  509. package/models/bid-contract-documents-v1-response-dto.ts +1 -1
  510. package/models/bid-created-response-dto.ts +1 -1
  511. package/models/bid-detail-response-dto.ts +1 -1
  512. package/models/bid-document-dto.ts +1 -1
  513. package/models/bid-document-v1-dto.ts +1 -1
  514. package/models/bid-failed-response-dto.ts +1 -1
  515. package/models/bid-failed-v2-response-dto.ts +1 -1
  516. package/models/bid-failure-reason.ts +1 -1
  517. package/models/bid-item-dto.ts +1 -1
  518. package/models/bid-item-v1-dto.ts +1 -1
  519. package/models/bid-lifecycle-dto.ts +1 -1
  520. package/models/bid-manager-dto.ts +1 -1
  521. package/models/bid-manager-v1-dto.ts +1 -1
  522. package/models/bid-participant-summary-dto.ts +1 -1
  523. package/models/bid-public-status.ts +1 -1
  524. package/models/bid-published-response-dto.ts +1 -1
  525. package/models/bid-registered-response-dto.ts +1 -1
  526. package/models/bid-result-participant-attachment-dto.ts +1 -1
  527. package/models/bid-result-participant-dto.ts +1 -1
  528. package/models/bid-result-v1-attachment-dto.ts +1 -1
  529. package/models/bid-result-v1-bid-product-info-dto.ts +1 -1
  530. package/models/bid-result-v1-participant-dto.ts +1 -1
  531. package/models/bid-result-v1-product-dto.ts +1 -1
  532. package/models/bid-results-batch-v1-request-dto.ts +1 -1
  533. package/models/bid-results-response-dto.ts +1 -1
  534. package/models/bid-results-v1-response-dto.ts +1 -1
  535. package/models/bid-settlement-line-item-dto.ts +1 -1
  536. package/models/bid-settlement-participant-dto.ts +1 -1
  537. package/models/bid-settlement-response-dto.ts +1 -1
  538. package/models/bid-statement-response-dto.ts +1 -1
  539. package/models/bid-statement-v1-response-dto.ts +1 -1
  540. package/models/bid-status.ts +1 -1
  541. package/models/bid-summary-dto.ts +1 -1
  542. package/models/bid-updated-response-dto.ts +1 -1
  543. package/models/card-payment-request-response-dto.ts +1 -1
  544. package/models/close-sandbox-bid-response-dto.ts +1 -1
  545. package/models/complete-acceptance-request-dto.ts +1 -1
  546. package/models/complete-acceptance-v1-request-dto.ts +1 -1
  547. package/models/contract-document-item-dto.ts +1 -1
  548. package/models/contract-documents-regenerated-response-dto.ts +1 -1
  549. package/models/contract-restriction-confirm-input-dto.ts +1 -1
  550. package/models/create-bid-request-dto.ts +1 -1
  551. package/models/create-bid-v1-request-dto.ts +1 -1
  552. package/models/create-card-payment-request-dto.ts +1 -1
  553. package/models/create-external-contract-documents-request-dto.ts +1 -1
  554. package/models/create-external-contract-documents-response-dto.ts +1 -1
  555. package/models/embed-launch-request-dto.ts +1 -1
  556. package/models/embed-launch-response-dto.ts +1 -1
  557. package/models/external-contract-document-item-dto.ts +1 -1
  558. package/models/external-contract-documents-response-dto.ts +1 -1
  559. package/models/external-contract-item-dto.ts +1 -1
  560. package/models/external-contract-snapshot-dto.ts +1 -1
  561. package/models/external-document-inputs-dto.ts +1 -1
  562. package/models/file-uploaded-response-dto.ts +1 -1
  563. package/models/file-uploaded-v1-response-dto.ts +1 -1
  564. package/models/generated-external-contract-document-dto.ts +1 -1
  565. package/models/health-response-dto.ts +1 -1
  566. package/models/hierarchical-region-dto.ts +1 -1
  567. package/models/hierarchical-region-v1-dto.ts +1 -1
  568. package/models/index.ts +5 -0
  569. package/models/invalid-param-dto.ts +1 -1
  570. package/models/invoice-completed-response-dto.ts +1 -1
  571. package/models/issue-tax-invoice-request-dto.ts +1 -1
  572. package/models/list-bids-response-dto.ts +1 -1
  573. package/models/mark-bid-failed-request-dto.ts +1 -1
  574. package/models/mark-bid-failed-v1-request-dto.ts +1 -1
  575. package/models/negotiation-score-dto.ts +1 -1
  576. package/models/negotiation-score-v1-dto.ts +1 -1
  577. package/models/negotiation-scored-response-dto.ts +1 -1
  578. package/models/negotiation-scored-v2-response-dto.ts +1 -1
  579. package/models/oauth-error-response-dto.ts +1 -1
  580. package/models/preconditions-dto.ts +1 -1
  581. package/models/preconditions-v1-dto.ts +1 -1
  582. package/models/problem-details-dto.ts +1 -1
  583. package/models/product-receipt-v1-response-dto.ts +1 -1
  584. package/models/product-v1-response-dto.ts +1 -1
  585. package/models/protected-resource-metadata-dto.ts +47 -0
  586. package/models/register-award-request-dto.ts +1 -1
  587. package/models/register-award-v1-request-dto.ts +1 -1
  588. package/models/register-semo-contract-request-dto.ts +71 -0
  589. package/models/request-split-invoice-v1-request-dto.ts +1 -1
  590. package/models/retiree-roster-input-dto.ts +1 -1
  591. package/models/retiree-roster-row-dto.ts +1 -1
  592. package/models/semo-contract-registered-response-dto.ts +31 -0
  593. package/models/semo-contract-taxinvoice-status-response-dto.ts +52 -0
  594. package/models/split-invoice-v1-response-dto.ts +1 -1
  595. package/models/statement-document-dto.ts +1 -1
  596. package/models/statement-product-dto.ts +1 -1
  597. package/models/statement-v1-document-dto.ts +1 -1
  598. package/models/statement-v1-product-dto.ts +1 -1
  599. package/models/submit-negotiation-scores-request-dto.ts +1 -1
  600. package/models/submit-negotiation-scores-v1-request-dto.ts +1 -1
  601. package/models/supplier-card-payable-response-dto.ts +1 -1
  602. package/models/supplier-tax-type.ts +1 -1
  603. package/models/tax-invoice-issued-response-dto.ts +1 -1
  604. package/models/token-request-dto.ts +1 -1
  605. package/models/token-response-dto.ts +1 -1
  606. package/models/update-bid-request-dto.ts +1 -1
  607. package/models/upload-file-request-dto.ts +1 -1
  608. package/models/upload-file-v1-request-dto.ts +1 -1
  609. package/package.json +1 -1
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -0,0 +1,62 @@
1
+ /**
2
+ * CMARKET V6 Partner API
3
+ * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (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
+ *
5
+ * The version of the OpenAPI document: 22.7.0
6
+ * Contact: semo.io.kr@gmail.com
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ export interface RegisterSemoContractRequestDto {
13
+ /**
14
+ * νŒŒνŠΈλ„ˆ μΈ‘ 계약 μ‹λ³„μž. **이 값이 λ©±λ“±ν‚€**μž…λ‹ˆλ‹€ β€” 같은 κ°’μœΌλ‘œ μž¬μš”μ²­ν•˜λ©΄ μƒˆλ‘œ λ§Œλ“€μ§€ μ•Šκ³  κΈ°μ‘΄ λ°œν–‰ λŒ€μƒμ„ λŒλ €μ€λ‹ˆλ‹€(`reused=true`).
15
+ */
16
+ 'externalContractId': string;
17
+ /**
18
+ * λ°œμ£ΌκΈ°κ΄€ νšŒμ› ID (μ”¨λ§ˆμΌ“ `member_id`). **κ³„μ‚°μ„œ κ³΅κΈ‰λ°›λŠ”μž**κ°€ λ©λ‹ˆλ‹€.
19
+ */
20
+ 'buyerMemberId': string;
21
+ /**
22
+ * 곡급기업 νšŒμ› ID (μ”¨λ§ˆμΌ“ `member_id`). **κ³„μ‚°μ„œ κ³΅κΈ‰μž(λ°œν–‰ 주체)**κ°€ λ©λ‹ˆλ‹€.
23
+ */
24
+ 'supplierMemberId': string;
25
+ /**
26
+ * 거래λͺ… β€” κ³„μ‚°μ„œ ν’ˆλͺ©λͺ…κ³Ό λͺ©λ‘ ν‘œμ‹œμ— μ“°μž…λ‹ˆλ‹€.
27
+ */
28
+ 'projectName': string;
29
+ /**
30
+ * κ³Όμ„Έ 곡급가앑 β€” **λΆ€κ°€μ„Έλ₯Ό λΊ€ κΈˆμ•‘**μž…λ‹ˆλ‹€(결제창 API 와 달리 포함가가 μ•„λ‹™λ‹ˆλ‹€).
31
+ */
32
+ 'supplyPrice': number;
33
+ /**
34
+ * λΆ€κ°€μ„Έ.
35
+ */
36
+ 'vatAmount': number;
37
+ /**
38
+ * λ©΄μ„Έ 곡급가앑. κ³Όμ„Έλ§Œ 있으면 0 을 λ³΄λƒ…λ‹ˆλ‹€.
39
+ */
40
+ 'taxFreeAmount': number;
41
+ /**
42
+ * νŒŒνŠΈλ„ˆ μΈ‘ κ³„μ•½λ²ˆν˜Έ β€” λͺ©λ‘Β·κ³„μ‚°μ„œ 쑰회의 μ‹€λ§ˆλ¦¬λ‘œ μ“°μž…λ‹ˆλ‹€.
43
+ */
44
+ 'externalContractNumber'?: string;
45
+ /**
46
+ * νŒŒνŠΈλ„ˆ μΈ‘ κ²¬μ μš”μ²­ μ‹λ³„μž.
47
+ */
48
+ 'externalQuoteRequestId'?: string;
49
+ /**
50
+ * νŒŒνŠΈλ„ˆ μΈ‘ μ ‘μˆ˜λ²ˆν˜Έ.
51
+ */
52
+ 'requestNumber'?: string;
53
+ /**
54
+ * 계약 μ‹œμ μ— λ°œμ£ΌκΈ°κ΄€μ΄ κ³ λ₯Έ λŒ€κΈˆ μ§€κΈ‰ μˆ˜λ‹¨. `cash` λŠ” κ³„μ‚°μ„œ λ°œν–‰μš”μ²­ 경둜, `card` λŠ” 결제창 κ²½λ‘œμž…λ‹ˆλ‹€. λͺ¨λ₯΄λ©΄ 보내지 μ•ŠμŠ΅λ‹ˆλ‹€.
55
+ */
56
+ 'paymentChannel'?: RegisterSemoContractRequestDtoPaymentChannelEnum;
57
+ }
58
+ export declare const RegisterSemoContractRequestDtoPaymentChannelEnum: {
59
+ readonly Cash: "cash";
60
+ readonly Card: "card";
61
+ };
62
+ export type RegisterSemoContractRequestDtoPaymentChannelEnum = typeof RegisterSemoContractRequestDtoPaymentChannelEnum[keyof typeof RegisterSemoContractRequestDtoPaymentChannelEnum];
@@ -0,0 +1,17 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * CMARKET V6 Partner API
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
+ *
7
+ * The version of the OpenAPI document: 22.7.0
8
+ * Contact: semo.io.kr@gmail.com
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ export const RegisterSemoContractRequestDtoPaymentChannelEnum = {
15
+ Cash: 'cash',
16
+ Card: 'card',
17
+ };
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -0,0 +1,25 @@
1
+ /**
2
+ * CMARKET V6 Partner API
3
+ * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (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
+ *
5
+ * The version of the OpenAPI document: 22.7.0
6
+ * Contact: semo.io.kr@gmail.com
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ export interface SemoContractRegisteredResponseDto {
13
+ /**
14
+ * μ”¨λ§ˆμΌ“ λ°œν–‰ λŒ€μƒ μ‹λ³„μž. **이후 κ³„μ‚°μ„œ κ΄€λ ¨ μ‘°νšŒμ— 이 값을 μ”λ‹ˆλ‹€** β€” νŒŒνŠΈλ„ˆ μΈ‘ 계약 id κ°€ μ•„λ‹™λ‹ˆλ‹€.
15
+ */
16
+ 'taxInvoiceTargetId': string;
17
+ /**
18
+ * 등둝 μƒνƒœ.
19
+ */
20
+ 'status': string;
21
+ /**
22
+ * 이미 등둝돼 μžˆμ–΄ κΈ°μ‘΄ λŒ€μƒμ„ κ·ΈλŒ€λ‘œ λŒλ €μ€€ 경우 `true`(λ©±λ“± μž¬μš”μ²­).
23
+ */
24
+ 'reused': boolean;
25
+ }
@@ -0,0 +1,14 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * CMARKET V6 Partner API
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
+ *
7
+ * The version of the OpenAPI document: 22.7.0
8
+ * Contact: semo.io.kr@gmail.com
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ export {};
@@ -0,0 +1,43 @@
1
+ /**
2
+ * CMARKET V6 Partner API
3
+ * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (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
+ *
5
+ * The version of the OpenAPI document: 22.7.0
6
+ * Contact: semo.io.kr@gmail.com
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ export interface SemoContractTaxinvoiceStatusResponseDto {
13
+ /**
14
+ * λ“±λ‘λœ λ°œν–‰ λŒ€μƒμ΄ μžˆλŠ”μ§€. `false` λ©΄ 아직 λ“±λ‘λ˜μ§€ μ•Šμ€ κ³„μ•½μž…λ‹ˆλ‹€.
15
+ */
16
+ 'found': boolean;
17
+ /**
18
+ * μ”¨λ§ˆμΌ“ λ°œν–‰ λŒ€μƒ μ‹λ³„μž. 미등둝이면 `null`.
19
+ */
20
+ 'taxInvoiceTargetId': string | null;
21
+ /**
22
+ * `NOT_REQUESTED` λ°œμ£ΌκΈ°κ΄€μ΄ 아직 λ°œκΈ‰μš”μ²­ μ•ˆ 함 Β· `REQUESTED` μš”μ²­λ¨(곡급기업 λ°œν–‰ λŒ€κΈ°) Β· `ISSUED` λ°œν–‰ μ™„λ£Œ.
23
+ */
24
+ 'status': SemoContractTaxinvoiceStatusResponseDtoStatusEnum;
25
+ /**
26
+ * κ³Όμ„Έ κ³„μ‚°μ„œ κ΄€λ¦¬λ²ˆν˜Έ.
27
+ */
28
+ 'mgtKeyTax': string | null;
29
+ /**
30
+ * λ©΄μ„Έ κ³„μ‚°μ„œ κ΄€λ¦¬λ²ˆν˜Έ.
31
+ */
32
+ 'mgtKeyTaxFree': string | null;
33
+ /**
34
+ * λ°œμ£ΌκΈ°κ΄€μ΄ λ°œκΈ‰μš”μ²­ μ‹œ μ§€μ •ν•œ μž‘μ„±μΌμž(ISO 8601).
35
+ */
36
+ 'writeDate': string | null;
37
+ }
38
+ export declare const SemoContractTaxinvoiceStatusResponseDtoStatusEnum: {
39
+ readonly NotRequested: "NOT_REQUESTED";
40
+ readonly Requested: "REQUESTED";
41
+ readonly Issued: "ISSUED";
42
+ };
43
+ export type SemoContractTaxinvoiceStatusResponseDtoStatusEnum = typeof SemoContractTaxinvoiceStatusResponseDtoStatusEnum[keyof typeof SemoContractTaxinvoiceStatusResponseDtoStatusEnum];
@@ -0,0 +1,18 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * CMARKET V6 Partner API
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
+ *
7
+ * The version of the OpenAPI document: 22.7.0
8
+ * Contact: semo.io.kr@gmail.com
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ export const SemoContractTaxinvoiceStatusResponseDtoStatusEnum = {
15
+ NotRequested: 'NOT_REQUESTED',
16
+ Requested: 'REQUESTED',
17
+ Issued: 'ISSUED',
18
+ };
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -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.5.0
7
+ * The version of the OpenAPI document: 22.7.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).