@cmarket/partner-sdk 25.1.0 β 31.1.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.
- package/README.md +86 -18
- package/api/oauth-api.ts +75 -2
- package/api/partner-v1-api.ts +14 -14
- package/api/partner-v2-api.ts +1627 -260
- package/api/well-known-api.ts +2 -2
- package/api.ts +2 -2
- package/base.ts +2 -2
- package/common.ts +2 -2
- package/configuration.ts +2 -2
- package/dist/api/oauth-api.d.ts +36 -2
- package/dist/api/oauth-api.js +69 -2
- package/dist/api/partner-v1-api.d.ts +2 -2
- package/dist/api/partner-v1-api.js +14 -14
- package/dist/api/partner-v2-api.d.ts +783 -172
- package/dist/api/partner-v2-api.js +1530 -254
- package/dist/api/well-known-api.d.ts +2 -2
- package/dist/api/well-known-api.js +2 -2
- package/dist/api.d.ts +2 -2
- package/dist/api.js +2 -2
- package/dist/base.d.ts +2 -2
- package/dist/base.js +2 -2
- package/dist/common.d.ts +2 -2
- package/dist/common.js +2 -2
- package/dist/configuration.d.ts +2 -2
- package/dist/configuration.js +2 -2
- package/dist/esm/api/oauth-api.d.ts +36 -2
- package/dist/esm/api/oauth-api.js +69 -2
- package/dist/esm/api/partner-v1-api.d.ts +2 -2
- package/dist/esm/api/partner-v1-api.js +14 -14
- package/dist/esm/api/partner-v2-api.d.ts +783 -172
- package/dist/esm/api/partner-v2-api.js +1529 -253
- package/dist/esm/api/well-known-api.d.ts +2 -2
- package/dist/esm/api/well-known-api.js +2 -2
- package/dist/esm/api.d.ts +2 -2
- package/dist/esm/api.js +2 -2
- package/dist/esm/base.d.ts +2 -2
- package/dist/esm/base.js +2 -2
- package/dist/esm/common.d.ts +2 -2
- package/dist/esm/common.js +2 -2
- package/dist/esm/configuration.d.ts +2 -2
- package/dist/esm/configuration.js +2 -2
- package/dist/esm/index.d.ts +2 -2
- package/dist/esm/index.js +2 -2
- package/dist/esm/models/acceptance-result-response-dto.d.ts +2 -2
- package/dist/esm/models/acceptance-result-response-dto.js +2 -2
- package/dist/esm/models/acceptance-result-v1-response-dto.d.ts +2 -2
- package/dist/esm/models/acceptance-result-v1-response-dto.js +2 -2
- package/dist/esm/models/acceptance-status-response-dto.d.ts +33 -0
- package/dist/esm/models/acceptance-status-response-dto.js +14 -0
- package/dist/esm/models/acknowledge-product-receipt200-response.d.ts +21 -0
- package/dist/esm/models/acknowledge-product-receipt200-response.js +14 -0
- package/dist/esm/models/acknowledge-products-request-dto.d.ts +17 -0
- package/dist/esm/models/acknowledge-products-request-dto.js +14 -0
- package/dist/esm/models/acknowledge-products-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/acknowledge-products-v1-request-dto.js +2 -2
- package/dist/esm/models/authorization-server-metadata-dto.d.ts +6 -2
- package/dist/esm/models/authorization-server-metadata-dto.js +2 -2
- package/dist/esm/models/award-method-public.d.ts +2 -2
- package/dist/esm/models/award-method-public.js +2 -2
- package/dist/esm/models/award-registered-response-dto.d.ts +2 -2
- package/dist/esm/models/award-registered-response-dto.js +2 -2
- package/dist/esm/models/award-registered-v2-response-dto.d.ts +2 -2
- package/dist/esm/models/award-registered-v2-response-dto.js +2 -2
- package/dist/esm/models/award-reverted-v2-response-dto.d.ts +25 -0
- package/dist/esm/models/award-reverted-v2-response-dto.js +16 -0
- package/dist/esm/models/bid-attachment-v1-dto.d.ts +2 -2
- package/dist/esm/models/bid-attachment-v1-dto.js +2 -2
- package/dist/esm/models/bid-bond-dto.d.ts +2 -2
- package/dist/esm/models/bid-bond-dto.js +2 -2
- package/dist/esm/models/bid-bond-v1-dto.d.ts +2 -2
- package/dist/esm/models/bid-bond-v1-dto.js +2 -2
- package/dist/esm/models/bid-cancelled-response-dto.d.ts +25 -0
- package/dist/esm/models/bid-cancelled-response-dto.js +16 -0
- package/dist/esm/models/bid-contact-dto.d.ts +25 -0
- package/dist/esm/models/bid-contact-dto.js +14 -0
- package/dist/esm/models/bid-contacts-dto.d.ts +22 -0
- package/dist/esm/models/bid-contacts-dto.js +14 -0
- package/dist/esm/models/bid-contract-document-dto.d.ts +60 -0
- package/dist/esm/models/bid-contract-document-dto.js +19 -0
- package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.js +2 -2
- package/dist/esm/models/bid-contract-documents-v1-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-contract-documents-v1-response-dto.js +2 -2
- package/dist/esm/models/bid-created-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-created-response-dto.js +2 -2
- package/dist/esm/models/bid-delivery-terms-dto.d.ts +33 -0
- package/dist/esm/models/bid-delivery-terms-dto.js +14 -0
- package/dist/esm/models/bid-detail-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-detail-response-dto.js +2 -2
- package/dist/esm/models/bid-document-dto.d.ts +2 -2
- package/dist/esm/models/bid-document-dto.js +2 -2
- package/dist/esm/models/bid-document-v1-dto.d.ts +2 -2
- package/dist/esm/models/bid-document-v1-dto.js +2 -2
- package/dist/esm/models/bid-failed-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-failed-response-dto.js +2 -2
- package/dist/esm/models/bid-failed-v2-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-failed-v2-response-dto.js +2 -2
- package/dist/esm/models/bid-failure-reason.d.ts +2 -2
- package/dist/esm/models/bid-failure-reason.js +2 -2
- package/dist/esm/models/bid-item-dto.d.ts +2 -2
- package/dist/esm/models/bid-item-dto.js +2 -2
- package/dist/esm/models/bid-item-v1-dto.d.ts +2 -2
- package/dist/esm/models/bid-item-v1-dto.js +2 -2
- package/dist/esm/models/bid-lifecycle-dto.d.ts +2 -2
- package/dist/esm/models/bid-lifecycle-dto.js +2 -2
- package/dist/esm/models/bid-manager-dto.d.ts +2 -2
- package/dist/esm/models/bid-manager-dto.js +2 -2
- package/dist/esm/models/bid-manager-v1-dto.d.ts +2 -2
- package/dist/esm/models/bid-manager-v1-dto.js +2 -2
- package/dist/esm/models/bid-participant-summary-dto.d.ts +2 -2
- package/dist/esm/models/bid-participant-summary-dto.js +2 -2
- package/dist/esm/models/bid-payment-terms-dto.d.ts +21 -0
- package/dist/esm/models/bid-payment-terms-dto.js +14 -0
- package/dist/esm/models/bid-product-dto.d.ts +37 -0
- package/dist/esm/models/bid-product-dto.js +14 -0
- package/dist/esm/models/bid-public-status.d.ts +2 -5
- package/dist/esm/models/bid-public-status.js +2 -5
- package/dist/esm/models/bid-published-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-published-response-dto.js +2 -2
- package/dist/esm/models/bid-registered-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-registered-response-dto.js +2 -2
- package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +2 -2
- package/dist/esm/models/bid-result-participant-attachment-dto.js +2 -2
- package/dist/esm/models/bid-result-participant-dto.d.ts +2 -2
- package/dist/esm/models/bid-result-participant-dto.js +2 -2
- package/dist/esm/models/bid-result-v1-attachment-dto.d.ts +2 -2
- package/dist/esm/models/bid-result-v1-attachment-dto.js +2 -2
- package/dist/esm/models/bid-result-v1-bid-product-info-dto.d.ts +2 -2
- package/dist/esm/models/bid-result-v1-bid-product-info-dto.js +2 -2
- package/dist/esm/models/bid-result-v1-participant-dto.d.ts +2 -2
- package/dist/esm/models/bid-result-v1-participant-dto.js +2 -2
- package/dist/esm/models/bid-result-v1-product-dto.d.ts +2 -2
- package/dist/esm/models/bid-result-v1-product-dto.js +2 -2
- package/dist/esm/models/bid-results-batch-request-dto.d.ts +17 -0
- package/dist/esm/models/bid-results-batch-request-dto.js +14 -0
- package/dist/esm/models/bid-results-batch-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/bid-results-batch-v1-request-dto.js +2 -2
- package/dist/esm/models/bid-results-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-results-response-dto.js +2 -2
- package/dist/esm/models/bid-results-v1-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-results-v1-response-dto.js +2 -2
- package/dist/esm/models/bid-settlement-line-item-dto.d.ts +2 -2
- package/dist/esm/models/bid-settlement-line-item-dto.js +2 -2
- package/dist/esm/models/bid-settlement-participant-dto.d.ts +2 -2
- package/dist/esm/models/bid-settlement-participant-dto.js +2 -2
- package/dist/esm/models/bid-settlement-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-settlement-response-dto.js +2 -2
- package/dist/esm/models/bid-statement-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-statement-response-dto.js +2 -2
- package/dist/esm/models/bid-statement-v1-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-statement-v1-response-dto.js +2 -2
- package/dist/esm/models/bid-status.d.ts +2 -2
- package/dist/esm/models/bid-status.js +2 -2
- package/dist/esm/models/bid-summary-dto.d.ts +39 -2
- package/dist/esm/models/bid-summary-dto.js +2 -2
- package/dist/esm/models/bid-updated-response-dto.d.ts +2 -2
- package/dist/esm/models/bid-updated-response-dto.js +2 -2
- package/dist/esm/models/cancel-bid-request-dto.d.ts +17 -0
- package/dist/esm/models/cancel-bid-request-dto.js +14 -0
- package/dist/esm/models/cancel-bid200-response.d.ts +21 -0
- package/dist/esm/models/cancel-bid200-response.js +14 -0
- package/dist/esm/models/card-payment-request-response-dto.d.ts +2 -2
- package/dist/esm/models/card-payment-request-response-dto.js +2 -2
- package/dist/esm/models/complete-acceptance-request-dto.d.ts +2 -2
- package/dist/esm/models/complete-acceptance-request-dto.js +2 -2
- package/dist/esm/models/complete-acceptance-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/complete-acceptance-v1-request-dto.js +2 -2
- package/dist/esm/models/complete-acceptance200-response.d.ts +21 -0
- package/dist/esm/models/complete-acceptance200-response.js +14 -0
- package/dist/esm/models/complete-invoice200-response.d.ts +21 -0
- package/dist/esm/models/complete-invoice200-response.js +14 -0
- package/dist/esm/models/contract-document-item-dto.d.ts +2 -2
- package/dist/esm/models/contract-document-item-dto.js +2 -2
- package/dist/esm/models/contract-documents-regenerated-response-dto.d.ts +2 -2
- package/dist/esm/models/contract-documents-regenerated-response-dto.js +2 -2
- package/dist/esm/models/contract-restriction-confirm-input-dto.d.ts +2 -2
- package/dist/esm/models/contract-restriction-confirm-input-dto.js +2 -2
- package/dist/esm/models/create-bid-request-dto.d.ts +2 -2
- package/dist/esm/models/create-bid-request-dto.js +2 -2
- package/dist/esm/models/create-bid-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/create-bid-v1-request-dto.js +2 -2
- package/dist/esm/models/create-card-payment-request-dto.d.ts +2 -2
- package/dist/esm/models/create-card-payment-request-dto.js +2 -2
- package/dist/esm/models/create-card-payment200-response.d.ts +21 -0
- package/dist/esm/models/create-card-payment200-response.js +14 -0
- package/dist/esm/models/create-external-contract-documents-request-dto.d.ts +2 -2
- package/dist/esm/models/create-external-contract-documents-request-dto.js +2 -2
- package/dist/esm/models/create-external-contract-documents-response-dto.d.ts +2 -2
- package/dist/esm/models/create-external-contract-documents-response-dto.js +2 -2
- package/dist/esm/models/create-webhook-endpoint-request-dto.d.ts +22 -0
- package/dist/esm/models/create-webhook-endpoint-request-dto.js +14 -0
- package/dist/esm/models/create-webhook-endpoint201-response.d.ts +21 -0
- package/dist/esm/models/create-webhook-endpoint201-response.js +14 -0
- package/dist/esm/models/external-contract-document-item-dto.d.ts +2 -2
- package/dist/esm/models/external-contract-document-item-dto.js +2 -2
- package/dist/esm/models/external-contract-documents-response-dto.d.ts +2 -2
- package/dist/esm/models/external-contract-documents-response-dto.js +2 -2
- package/dist/esm/models/external-contract-item-dto.d.ts +2 -2
- package/dist/esm/models/external-contract-item-dto.js +2 -2
- package/dist/esm/models/external-contract-snapshot-dto.d.ts +2 -2
- package/dist/esm/models/external-contract-snapshot-dto.js +2 -2
- package/dist/esm/models/external-document-inputs-dto.d.ts +2 -2
- package/dist/esm/models/external-document-inputs-dto.js +2 -2
- package/dist/esm/models/file-meta-response-dto.d.ts +33 -0
- package/dist/esm/models/file-meta-response-dto.js +14 -0
- package/dist/esm/models/file-uploaded-response-dto.d.ts +2 -2
- package/dist/esm/models/file-uploaded-response-dto.js +2 -2
- package/dist/esm/models/file-uploaded-v1-response-dto.d.ts +2 -2
- package/dist/esm/models/file-uploaded-v1-response-dto.js +2 -2
- package/dist/esm/models/generated-external-contract-document-dto.d.ts +2 -2
- package/dist/esm/models/generated-external-contract-document-dto.js +2 -2
- package/dist/esm/models/get-bid-acceptance200-response.d.ts +21 -0
- package/dist/esm/models/get-bid-acceptance200-response.js +14 -0
- package/dist/esm/models/get-bid-results200-response.d.ts +21 -0
- package/dist/esm/models/get-bid-results200-response.js +14 -0
- package/dist/esm/models/get-bid-settlement200-response.d.ts +21 -0
- package/dist/esm/models/get-bid-settlement200-response.js +14 -0
- package/dist/esm/models/get-bid-statement200-response.d.ts +21 -0
- package/dist/esm/models/get-bid-statement200-response.js +14 -0
- package/dist/esm/models/get-bid200-response.d.ts +21 -0
- package/dist/esm/models/get-bid200-response.js +14 -0
- package/dist/esm/models/get-file-meta200-response.d.ts +21 -0
- package/dist/esm/models/get-file-meta200-response.js +14 -0
- package/dist/esm/models/get-supplier-card-payable-v2200-response.d.ts +21 -0
- package/dist/esm/models/get-supplier-card-payable-v2200-response.js +14 -0
- package/dist/esm/models/get-webhook-endpoint200-response.d.ts +21 -0
- package/dist/esm/models/get-webhook-endpoint200-response.js +14 -0
- package/dist/esm/models/health-controller-check200-response.d.ts +21 -0
- package/dist/esm/models/health-controller-check200-response.js +14 -0
- package/dist/esm/models/health-response-dto.d.ts +2 -2
- package/dist/esm/models/health-response-dto.js +2 -2
- package/dist/esm/models/hierarchical-region-dto.d.ts +2 -2
- package/dist/esm/models/hierarchical-region-dto.js +2 -2
- package/dist/esm/models/hierarchical-region-v1-dto.d.ts +2 -2
- package/dist/esm/models/hierarchical-region-v1-dto.js +2 -2
- package/dist/esm/models/index.d.ts +59 -8
- package/dist/esm/models/index.js +59 -8
- package/dist/esm/models/introspect-request-dto.d.ts +46 -0
- package/dist/esm/models/introspect-request-dto.js +20 -0
- package/dist/esm/models/introspection-response-dto.d.ts +45 -0
- package/dist/esm/models/introspection-response-dto.js +14 -0
- package/dist/esm/models/invalid-param-dto.d.ts +2 -2
- package/dist/esm/models/invalid-param-dto.js +2 -2
- package/dist/esm/models/invoice-completed-response-dto.d.ts +2 -2
- package/dist/esm/models/invoice-completed-response-dto.js +2 -2
- package/dist/esm/models/list-bid-contract-documents200-response.d.ts +21 -0
- package/dist/esm/models/list-bid-contract-documents200-response.js +14 -0
- package/dist/esm/models/list-bid-participants200-response.d.ts +21 -0
- package/dist/esm/models/list-bid-participants200-response.js +14 -0
- package/dist/esm/models/list-bid-results200-response.d.ts +21 -0
- package/dist/esm/models/list-bid-results200-response.js +14 -0
- package/dist/esm/models/list-bids-response-dto.d.ts +2 -2
- package/dist/esm/models/list-bids-response-dto.js +2 -2
- package/dist/esm/models/list-bids200-response.d.ts +21 -0
- package/dist/esm/models/list-bids200-response.js +14 -0
- package/dist/esm/models/list-products200-response.d.ts +21 -0
- package/dist/esm/models/list-products200-response.js +14 -0
- package/dist/esm/models/list-webhook-deliveries-response-dto.d.ts +22 -0
- package/dist/esm/models/list-webhook-deliveries-response-dto.js +14 -0
- package/dist/esm/models/list-webhook-deliveries200-response.d.ts +21 -0
- package/dist/esm/models/list-webhook-deliveries200-response.js +14 -0
- package/dist/esm/models/list-webhook-endpoints200-response.d.ts +21 -0
- package/dist/esm/models/list-webhook-endpoints200-response.js +14 -0
- package/dist/esm/models/mark-bid-failed-request-dto.d.ts +2 -2
- package/dist/esm/models/mark-bid-failed-request-dto.js +2 -2
- package/dist/esm/models/mark-bid-failed-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/mark-bid-failed-v1-request-dto.js +2 -2
- package/dist/esm/models/mark-bid-failed201-response.d.ts +21 -0
- package/dist/esm/models/mark-bid-failed201-response.js +14 -0
- package/dist/esm/models/negotiation-score-v1-dto.d.ts +2 -2
- package/dist/esm/models/negotiation-score-v1-dto.js +2 -2
- package/dist/esm/models/negotiation-scored-response-dto.d.ts +2 -2
- package/dist/esm/models/negotiation-scored-response-dto.js +2 -2
- package/dist/esm/models/oauth-error-response-dto.d.ts +2 -2
- package/dist/esm/models/oauth-error-response-dto.js +2 -2
- package/dist/esm/models/partner-webhook-delivery-status.d.ts +18 -0
- package/dist/esm/models/partner-webhook-delivery-status.js +19 -0
- package/dist/esm/models/partner-webhook-endpoint-status.d.ts +19 -0
- package/dist/esm/models/partner-webhook-endpoint-status.js +20 -0
- package/dist/esm/models/partner-webhook-event-type.d.ts +22 -0
- package/dist/esm/models/partner-webhook-event-type.js +23 -0
- package/dist/esm/models/preconditions-dto.d.ts +2 -2
- package/dist/esm/models/preconditions-dto.js +2 -2
- package/dist/esm/models/preconditions-v1-dto.d.ts +2 -2
- package/dist/esm/models/preconditions-v1-dto.js +2 -2
- package/dist/esm/models/problem-details-dto.d.ts +7 -3
- package/dist/esm/models/problem-details-dto.js +2 -2
- package/dist/esm/models/product-receipt-response-dto.d.ts +17 -0
- package/dist/esm/models/product-receipt-response-dto.js +14 -0
- package/dist/esm/models/product-receipt-v1-response-dto.d.ts +2 -2
- package/dist/esm/models/product-receipt-v1-response-dto.js +2 -2
- package/dist/esm/models/product-response-dto.d.ts +77 -0
- package/dist/esm/models/product-response-dto.js +14 -0
- package/dist/esm/models/product-v1-response-dto.d.ts +2 -2
- package/dist/esm/models/product-v1-response-dto.js +2 -2
- package/dist/esm/models/protected-resource-metadata-dto.d.ts +2 -2
- package/dist/esm/models/protected-resource-metadata-dto.js +2 -2
- package/dist/esm/models/publish-bid200-response.d.ts +21 -0
- package/dist/esm/models/publish-bid200-response.js +14 -0
- package/dist/esm/models/regenerate-contract-documents201-response.d.ts +21 -0
- package/dist/esm/models/regenerate-contract-documents201-response.js +14 -0
- package/dist/esm/models/register-award-request-dto.d.ts +2 -2
- package/dist/esm/models/register-award-request-dto.js +2 -2
- package/dist/esm/models/register-award-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/register-award-v1-request-dto.js +2 -2
- package/dist/esm/models/register-award201-response.d.ts +21 -0
- package/dist/esm/models/register-award201-response.js +14 -0
- package/dist/esm/models/register-bid201-response.d.ts +21 -0
- package/dist/esm/models/register-bid201-response.js +14 -0
- package/dist/esm/models/register-semo-contract-request-dto.d.ts +2 -2
- package/dist/esm/models/register-semo-contract-request-dto.js +2 -2
- package/dist/esm/models/request-split-invoice-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/request-split-invoice-v1-request-dto.js +2 -2
- package/dist/esm/models/retiree-roster-input-dto.d.ts +2 -2
- package/dist/esm/models/retiree-roster-input-dto.js +2 -2
- package/dist/esm/models/retiree-roster-row-dto.d.ts +2 -2
- package/dist/esm/models/retiree-roster-row-dto.js +2 -2
- package/dist/esm/models/revert-award-request-dto.d.ts +17 -0
- package/dist/esm/models/revert-award-request-dto.js +14 -0
- package/dist/esm/models/revert-award200-response.d.ts +21 -0
- package/dist/esm/models/revert-award200-response.js +14 -0
- package/dist/esm/models/revoke-request-dto.d.ts +2 -2
- package/dist/esm/models/revoke-request-dto.js +2 -2
- package/dist/esm/models/semo-contract-registered-response-dto.d.ts +2 -2
- package/dist/esm/models/semo-contract-registered-response-dto.js +2 -2
- package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
- package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
- package/dist/esm/models/send-webhook-test-event200-response.d.ts +21 -0
- package/dist/esm/models/send-webhook-test-event200-response.js +14 -0
- package/dist/esm/models/split-invoice-v1-response-dto.d.ts +2 -2
- package/dist/esm/models/split-invoice-v1-response-dto.js +2 -2
- package/dist/esm/models/statement-document-dto.d.ts +2 -2
- package/dist/esm/models/statement-document-dto.js +2 -2
- package/dist/esm/models/statement-product-dto.d.ts +2 -2
- package/dist/esm/models/statement-product-dto.js +2 -2
- package/dist/esm/models/statement-v1-document-dto.d.ts +2 -2
- package/dist/esm/models/statement-v1-document-dto.js +2 -2
- package/dist/esm/models/statement-v1-product-dto.d.ts +2 -2
- package/dist/esm/models/statement-v1-product-dto.js +2 -2
- package/dist/esm/models/submit-negotiation-scores-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/submit-negotiation-scores-v1-request-dto.js +2 -2
- package/dist/esm/models/supplier-card-payable-response-dto.d.ts +2 -2
- package/dist/esm/models/supplier-card-payable-response-dto.js +2 -2
- package/dist/esm/models/supplier-tax-type.d.ts +2 -2
- package/dist/esm/models/supplier-tax-type.js +2 -2
- package/dist/esm/models/token-request-dto.d.ts +2 -2
- package/dist/esm/models/token-request-dto.js +2 -2
- package/dist/esm/models/token-response-dto.d.ts +2 -2
- package/dist/esm/models/token-response-dto.js +2 -2
- package/dist/esm/models/update-bid-request-dto.d.ts +2 -2
- package/dist/esm/models/update-bid-request-dto.js +2 -2
- package/dist/esm/models/update-bid200-response.d.ts +21 -0
- package/dist/esm/models/update-bid200-response.js +14 -0
- package/dist/esm/models/update-webhook-endpoint-request-dto.d.ts +27 -0
- package/dist/esm/models/update-webhook-endpoint-request-dto.js +14 -0
- package/dist/esm/models/upload-file-request-dto.d.ts +2 -2
- package/dist/esm/models/upload-file-request-dto.js +2 -2
- package/dist/esm/models/upload-file-v1-request-dto.d.ts +2 -2
- package/dist/esm/models/upload-file-v1-request-dto.js +2 -2
- package/dist/esm/models/upload-file201-response.d.ts +21 -0
- package/dist/esm/models/upload-file201-response.js +14 -0
- package/dist/esm/models/webhook-delivery-dto.d.ts +73 -0
- package/dist/esm/models/webhook-delivery-dto.js +21 -0
- package/dist/esm/models/webhook-endpoint-dto.d.ts +55 -0
- package/dist/esm/models/webhook-endpoint-dto.js +14 -0
- package/dist/esm/models/webhook-endpoint-with-secret-dto.d.ts +59 -0
- package/dist/esm/models/webhook-endpoint-with-secret-dto.js +14 -0
- package/dist/esm/models/webhook-test-result-dto.d.ts +25 -0
- package/dist/esm/models/webhook-test-result-dto.js +14 -0
- package/dist/index.d.ts +2 -2
- package/dist/index.js +2 -2
- package/dist/models/acceptance-result-response-dto.d.ts +2 -2
- package/dist/models/acceptance-result-response-dto.js +2 -2
- package/dist/models/acceptance-result-v1-response-dto.d.ts +2 -2
- package/dist/models/acceptance-result-v1-response-dto.js +2 -2
- package/dist/models/acceptance-status-response-dto.d.ts +33 -0
- package/dist/models/acceptance-status-response-dto.js +15 -0
- package/dist/models/acknowledge-product-receipt200-response.d.ts +21 -0
- package/dist/models/acknowledge-product-receipt200-response.js +15 -0
- package/dist/models/acknowledge-products-request-dto.d.ts +17 -0
- package/dist/models/acknowledge-products-request-dto.js +15 -0
- package/dist/models/acknowledge-products-v1-request-dto.d.ts +2 -2
- package/dist/models/acknowledge-products-v1-request-dto.js +2 -2
- package/dist/models/authorization-server-metadata-dto.d.ts +6 -2
- package/dist/models/authorization-server-metadata-dto.js +2 -2
- package/dist/models/award-method-public.d.ts +2 -2
- package/dist/models/award-method-public.js +2 -2
- package/dist/models/award-registered-response-dto.d.ts +2 -2
- package/dist/models/award-registered-response-dto.js +2 -2
- package/dist/models/award-registered-v2-response-dto.d.ts +2 -2
- package/dist/models/award-registered-v2-response-dto.js +2 -2
- package/dist/models/award-reverted-v2-response-dto.d.ts +25 -0
- package/dist/models/award-reverted-v2-response-dto.js +19 -0
- package/dist/models/bid-attachment-v1-dto.d.ts +2 -2
- package/dist/models/bid-attachment-v1-dto.js +2 -2
- package/dist/models/bid-bond-dto.d.ts +2 -2
- package/dist/models/bid-bond-dto.js +2 -2
- package/dist/models/bid-bond-v1-dto.d.ts +2 -2
- package/dist/models/bid-bond-v1-dto.js +2 -2
- package/dist/models/bid-cancelled-response-dto.d.ts +25 -0
- package/dist/models/bid-cancelled-response-dto.js +19 -0
- package/dist/models/bid-contact-dto.d.ts +25 -0
- package/dist/models/bid-contact-dto.js +15 -0
- package/dist/models/bid-contacts-dto.d.ts +22 -0
- package/dist/models/bid-contacts-dto.js +15 -0
- package/dist/models/bid-contract-document-dto.d.ts +60 -0
- package/dist/models/bid-contract-document-dto.js +22 -0
- package/dist/models/bid-contract-documents-batch-v1-request-dto.d.ts +2 -2
- package/dist/models/bid-contract-documents-batch-v1-request-dto.js +2 -2
- package/dist/models/bid-contract-documents-v1-response-dto.d.ts +2 -2
- package/dist/models/bid-contract-documents-v1-response-dto.js +2 -2
- package/dist/models/bid-created-response-dto.d.ts +2 -2
- package/dist/models/bid-created-response-dto.js +2 -2
- package/dist/models/bid-delivery-terms-dto.d.ts +33 -0
- package/dist/models/bid-delivery-terms-dto.js +15 -0
- package/dist/models/bid-detail-response-dto.d.ts +2 -2
- package/dist/models/bid-detail-response-dto.js +2 -2
- package/dist/models/bid-document-dto.d.ts +2 -2
- package/dist/models/bid-document-dto.js +2 -2
- package/dist/models/bid-document-v1-dto.d.ts +2 -2
- package/dist/models/bid-document-v1-dto.js +2 -2
- package/dist/models/bid-failed-response-dto.d.ts +2 -2
- package/dist/models/bid-failed-response-dto.js +2 -2
- package/dist/models/bid-failed-v2-response-dto.d.ts +2 -2
- package/dist/models/bid-failed-v2-response-dto.js +2 -2
- package/dist/models/bid-failure-reason.d.ts +2 -2
- package/dist/models/bid-failure-reason.js +2 -2
- package/dist/models/bid-item-dto.d.ts +2 -2
- package/dist/models/bid-item-dto.js +2 -2
- package/dist/models/bid-item-v1-dto.d.ts +2 -2
- package/dist/models/bid-item-v1-dto.js +2 -2
- package/dist/models/bid-lifecycle-dto.d.ts +2 -2
- package/dist/models/bid-lifecycle-dto.js +2 -2
- package/dist/models/bid-manager-dto.d.ts +2 -2
- package/dist/models/bid-manager-dto.js +2 -2
- package/dist/models/bid-manager-v1-dto.d.ts +2 -2
- package/dist/models/bid-manager-v1-dto.js +2 -2
- package/dist/models/bid-participant-summary-dto.d.ts +2 -2
- package/dist/models/bid-participant-summary-dto.js +2 -2
- package/dist/models/bid-payment-terms-dto.d.ts +21 -0
- package/dist/models/bid-payment-terms-dto.js +15 -0
- package/dist/models/bid-product-dto.d.ts +37 -0
- package/dist/models/bid-product-dto.js +15 -0
- package/dist/models/bid-public-status.d.ts +2 -5
- package/dist/models/bid-public-status.js +2 -5
- package/dist/models/bid-published-response-dto.d.ts +2 -2
- package/dist/models/bid-published-response-dto.js +2 -2
- package/dist/models/bid-registered-response-dto.d.ts +2 -2
- package/dist/models/bid-registered-response-dto.js +2 -2
- package/dist/models/bid-result-participant-attachment-dto.d.ts +2 -2
- package/dist/models/bid-result-participant-attachment-dto.js +2 -2
- package/dist/models/bid-result-participant-dto.d.ts +2 -2
- package/dist/models/bid-result-participant-dto.js +2 -2
- package/dist/models/bid-result-v1-attachment-dto.d.ts +2 -2
- package/dist/models/bid-result-v1-attachment-dto.js +2 -2
- package/dist/models/bid-result-v1-bid-product-info-dto.d.ts +2 -2
- package/dist/models/bid-result-v1-bid-product-info-dto.js +2 -2
- package/dist/models/bid-result-v1-participant-dto.d.ts +2 -2
- package/dist/models/bid-result-v1-participant-dto.js +2 -2
- package/dist/models/bid-result-v1-product-dto.d.ts +2 -2
- package/dist/models/bid-result-v1-product-dto.js +2 -2
- package/dist/models/bid-results-batch-request-dto.d.ts +17 -0
- package/dist/models/bid-results-batch-request-dto.js +15 -0
- package/dist/models/bid-results-batch-v1-request-dto.d.ts +2 -2
- package/dist/models/bid-results-batch-v1-request-dto.js +2 -2
- package/dist/models/bid-results-response-dto.d.ts +2 -2
- package/dist/models/bid-results-response-dto.js +2 -2
- package/dist/models/bid-results-v1-response-dto.d.ts +2 -2
- package/dist/models/bid-results-v1-response-dto.js +2 -2
- package/dist/models/bid-settlement-line-item-dto.d.ts +2 -2
- package/dist/models/bid-settlement-line-item-dto.js +2 -2
- package/dist/models/bid-settlement-participant-dto.d.ts +2 -2
- package/dist/models/bid-settlement-participant-dto.js +2 -2
- package/dist/models/bid-settlement-response-dto.d.ts +2 -2
- package/dist/models/bid-settlement-response-dto.js +2 -2
- package/dist/models/bid-statement-response-dto.d.ts +2 -2
- package/dist/models/bid-statement-response-dto.js +2 -2
- package/dist/models/bid-statement-v1-response-dto.d.ts +2 -2
- package/dist/models/bid-statement-v1-response-dto.js +2 -2
- package/dist/models/bid-status.d.ts +2 -2
- package/dist/models/bid-status.js +2 -2
- package/dist/models/bid-summary-dto.d.ts +39 -2
- package/dist/models/bid-summary-dto.js +2 -2
- package/dist/models/bid-updated-response-dto.d.ts +2 -2
- package/dist/models/bid-updated-response-dto.js +2 -2
- package/dist/models/cancel-bid-request-dto.d.ts +17 -0
- package/dist/models/cancel-bid-request-dto.js +15 -0
- package/dist/models/cancel-bid200-response.d.ts +21 -0
- package/dist/models/cancel-bid200-response.js +15 -0
- package/dist/models/card-payment-request-response-dto.d.ts +2 -2
- package/dist/models/card-payment-request-response-dto.js +2 -2
- package/dist/models/complete-acceptance-request-dto.d.ts +2 -2
- package/dist/models/complete-acceptance-request-dto.js +2 -2
- package/dist/models/complete-acceptance-v1-request-dto.d.ts +2 -2
- package/dist/models/complete-acceptance-v1-request-dto.js +2 -2
- package/dist/models/complete-acceptance200-response.d.ts +21 -0
- package/dist/models/complete-acceptance200-response.js +15 -0
- package/dist/models/complete-invoice200-response.d.ts +21 -0
- package/dist/models/complete-invoice200-response.js +15 -0
- package/dist/models/contract-document-item-dto.d.ts +2 -2
- package/dist/models/contract-document-item-dto.js +2 -2
- package/dist/models/contract-documents-regenerated-response-dto.d.ts +2 -2
- package/dist/models/contract-documents-regenerated-response-dto.js +2 -2
- package/dist/models/contract-restriction-confirm-input-dto.d.ts +2 -2
- package/dist/models/contract-restriction-confirm-input-dto.js +2 -2
- package/dist/models/create-bid-request-dto.d.ts +2 -2
- package/dist/models/create-bid-request-dto.js +2 -2
- package/dist/models/create-bid-v1-request-dto.d.ts +2 -2
- package/dist/models/create-bid-v1-request-dto.js +2 -2
- package/dist/models/create-card-payment-request-dto.d.ts +2 -2
- package/dist/models/create-card-payment-request-dto.js +2 -2
- package/dist/models/create-card-payment200-response.d.ts +21 -0
- package/dist/models/create-card-payment200-response.js +15 -0
- package/dist/models/create-external-contract-documents-request-dto.d.ts +2 -2
- package/dist/models/create-external-contract-documents-request-dto.js +2 -2
- package/dist/models/create-external-contract-documents-response-dto.d.ts +2 -2
- package/dist/models/create-external-contract-documents-response-dto.js +2 -2
- package/dist/models/create-webhook-endpoint-request-dto.d.ts +22 -0
- package/dist/models/create-webhook-endpoint-request-dto.js +15 -0
- package/dist/models/create-webhook-endpoint201-response.d.ts +21 -0
- package/dist/models/create-webhook-endpoint201-response.js +15 -0
- package/dist/models/external-contract-document-item-dto.d.ts +2 -2
- package/dist/models/external-contract-document-item-dto.js +2 -2
- package/dist/models/external-contract-documents-response-dto.d.ts +2 -2
- package/dist/models/external-contract-documents-response-dto.js +2 -2
- package/dist/models/external-contract-item-dto.d.ts +2 -2
- package/dist/models/external-contract-item-dto.js +2 -2
- package/dist/models/external-contract-snapshot-dto.d.ts +2 -2
- package/dist/models/external-contract-snapshot-dto.js +2 -2
- package/dist/models/external-document-inputs-dto.d.ts +2 -2
- package/dist/models/external-document-inputs-dto.js +2 -2
- package/dist/models/file-meta-response-dto.d.ts +33 -0
- package/dist/models/file-meta-response-dto.js +15 -0
- package/dist/models/file-uploaded-response-dto.d.ts +2 -2
- package/dist/models/file-uploaded-response-dto.js +2 -2
- package/dist/models/file-uploaded-v1-response-dto.d.ts +2 -2
- package/dist/models/file-uploaded-v1-response-dto.js +2 -2
- package/dist/models/generated-external-contract-document-dto.d.ts +2 -2
- package/dist/models/generated-external-contract-document-dto.js +2 -2
- package/dist/models/get-bid-acceptance200-response.d.ts +21 -0
- package/dist/models/get-bid-acceptance200-response.js +15 -0
- package/dist/models/get-bid-results200-response.d.ts +21 -0
- package/dist/models/get-bid-results200-response.js +15 -0
- package/dist/models/get-bid-settlement200-response.d.ts +21 -0
- package/dist/models/get-bid-settlement200-response.js +15 -0
- package/dist/models/get-bid-statement200-response.d.ts +21 -0
- package/dist/models/get-bid-statement200-response.js +15 -0
- package/dist/models/get-bid200-response.d.ts +21 -0
- package/dist/models/get-bid200-response.js +15 -0
- package/dist/models/get-file-meta200-response.d.ts +21 -0
- package/dist/models/get-file-meta200-response.js +15 -0
- package/dist/models/get-supplier-card-payable-v2200-response.d.ts +21 -0
- package/dist/models/get-supplier-card-payable-v2200-response.js +15 -0
- package/dist/models/get-webhook-endpoint200-response.d.ts +21 -0
- package/dist/models/get-webhook-endpoint200-response.js +15 -0
- package/dist/models/health-controller-check200-response.d.ts +21 -0
- package/dist/models/health-controller-check200-response.js +15 -0
- package/dist/models/health-response-dto.d.ts +2 -2
- package/dist/models/health-response-dto.js +2 -2
- package/dist/models/hierarchical-region-dto.d.ts +2 -2
- package/dist/models/hierarchical-region-dto.js +2 -2
- package/dist/models/hierarchical-region-v1-dto.d.ts +2 -2
- package/dist/models/hierarchical-region-v1-dto.js +2 -2
- package/dist/models/index.d.ts +59 -8
- package/dist/models/index.js +59 -8
- package/dist/models/introspect-request-dto.d.ts +46 -0
- package/dist/models/introspect-request-dto.js +23 -0
- package/dist/models/introspection-response-dto.d.ts +45 -0
- package/dist/models/introspection-response-dto.js +15 -0
- package/dist/models/invalid-param-dto.d.ts +2 -2
- package/dist/models/invalid-param-dto.js +2 -2
- package/dist/models/invoice-completed-response-dto.d.ts +2 -2
- package/dist/models/invoice-completed-response-dto.js +2 -2
- package/dist/models/list-bid-contract-documents200-response.d.ts +21 -0
- package/dist/models/list-bid-contract-documents200-response.js +15 -0
- package/dist/models/list-bid-participants200-response.d.ts +21 -0
- package/dist/models/list-bid-participants200-response.js +15 -0
- package/dist/models/list-bid-results200-response.d.ts +21 -0
- package/dist/models/list-bid-results200-response.js +15 -0
- package/dist/models/list-bids-response-dto.d.ts +2 -2
- package/dist/models/list-bids-response-dto.js +2 -2
- package/dist/models/list-bids200-response.d.ts +21 -0
- package/dist/models/list-bids200-response.js +15 -0
- package/dist/models/list-products200-response.d.ts +21 -0
- package/dist/models/list-products200-response.js +15 -0
- package/dist/models/list-webhook-deliveries-response-dto.d.ts +22 -0
- package/dist/models/list-webhook-deliveries-response-dto.js +15 -0
- package/dist/models/list-webhook-deliveries200-response.d.ts +21 -0
- package/dist/models/list-webhook-deliveries200-response.js +15 -0
- package/dist/models/list-webhook-endpoints200-response.d.ts +21 -0
- package/dist/models/list-webhook-endpoints200-response.js +15 -0
- package/dist/models/mark-bid-failed-request-dto.d.ts +2 -2
- package/dist/models/mark-bid-failed-request-dto.js +2 -2
- package/dist/models/mark-bid-failed-v1-request-dto.d.ts +2 -2
- package/dist/models/mark-bid-failed-v1-request-dto.js +2 -2
- package/dist/models/mark-bid-failed201-response.d.ts +21 -0
- package/dist/models/mark-bid-failed201-response.js +15 -0
- package/dist/models/negotiation-score-v1-dto.d.ts +2 -2
- package/dist/models/negotiation-score-v1-dto.js +2 -2
- package/dist/models/negotiation-scored-response-dto.d.ts +2 -2
- package/dist/models/negotiation-scored-response-dto.js +2 -2
- package/dist/models/oauth-error-response-dto.d.ts +2 -2
- package/dist/models/oauth-error-response-dto.js +2 -2
- package/dist/models/partner-webhook-delivery-status.d.ts +18 -0
- package/dist/models/partner-webhook-delivery-status.js +22 -0
- package/dist/models/partner-webhook-endpoint-status.d.ts +19 -0
- package/dist/models/partner-webhook-endpoint-status.js +23 -0
- package/dist/models/partner-webhook-event-type.d.ts +22 -0
- package/dist/models/partner-webhook-event-type.js +26 -0
- package/dist/models/preconditions-dto.d.ts +2 -2
- package/dist/models/preconditions-dto.js +2 -2
- package/dist/models/preconditions-v1-dto.d.ts +2 -2
- package/dist/models/preconditions-v1-dto.js +2 -2
- package/dist/models/problem-details-dto.d.ts +7 -3
- package/dist/models/problem-details-dto.js +2 -2
- package/dist/models/product-receipt-response-dto.d.ts +17 -0
- package/dist/models/product-receipt-response-dto.js +15 -0
- package/dist/models/product-receipt-v1-response-dto.d.ts +2 -2
- package/dist/models/product-receipt-v1-response-dto.js +2 -2
- package/dist/models/product-response-dto.d.ts +77 -0
- package/dist/models/product-response-dto.js +15 -0
- package/dist/models/product-v1-response-dto.d.ts +2 -2
- package/dist/models/product-v1-response-dto.js +2 -2
- package/dist/models/protected-resource-metadata-dto.d.ts +2 -2
- package/dist/models/protected-resource-metadata-dto.js +2 -2
- package/dist/models/publish-bid200-response.d.ts +21 -0
- package/dist/models/publish-bid200-response.js +15 -0
- package/dist/models/regenerate-contract-documents201-response.d.ts +21 -0
- package/dist/models/regenerate-contract-documents201-response.js +15 -0
- package/dist/models/register-award-request-dto.d.ts +2 -2
- package/dist/models/register-award-request-dto.js +2 -2
- package/dist/models/register-award-v1-request-dto.d.ts +2 -2
- package/dist/models/register-award-v1-request-dto.js +2 -2
- package/dist/models/register-award201-response.d.ts +21 -0
- package/dist/models/register-award201-response.js +15 -0
- package/dist/models/register-bid201-response.d.ts +21 -0
- package/dist/models/register-bid201-response.js +15 -0
- package/dist/models/register-semo-contract-request-dto.d.ts +2 -2
- package/dist/models/register-semo-contract-request-dto.js +2 -2
- package/dist/models/request-split-invoice-v1-request-dto.d.ts +2 -2
- package/dist/models/request-split-invoice-v1-request-dto.js +2 -2
- package/dist/models/retiree-roster-input-dto.d.ts +2 -2
- package/dist/models/retiree-roster-input-dto.js +2 -2
- package/dist/models/retiree-roster-row-dto.d.ts +2 -2
- package/dist/models/retiree-roster-row-dto.js +2 -2
- package/dist/models/revert-award-request-dto.d.ts +17 -0
- package/dist/models/revert-award-request-dto.js +15 -0
- package/dist/models/revert-award200-response.d.ts +21 -0
- package/dist/models/revert-award200-response.js +15 -0
- package/dist/models/revoke-request-dto.d.ts +2 -2
- package/dist/models/revoke-request-dto.js +2 -2
- package/dist/models/semo-contract-registered-response-dto.d.ts +2 -2
- package/dist/models/semo-contract-registered-response-dto.js +2 -2
- package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
- package/dist/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
- package/dist/models/send-webhook-test-event200-response.d.ts +21 -0
- package/dist/models/send-webhook-test-event200-response.js +15 -0
- package/dist/models/split-invoice-v1-response-dto.d.ts +2 -2
- package/dist/models/split-invoice-v1-response-dto.js +2 -2
- package/dist/models/statement-document-dto.d.ts +2 -2
- package/dist/models/statement-document-dto.js +2 -2
- package/dist/models/statement-product-dto.d.ts +2 -2
- package/dist/models/statement-product-dto.js +2 -2
- package/dist/models/statement-v1-document-dto.d.ts +2 -2
- package/dist/models/statement-v1-document-dto.js +2 -2
- package/dist/models/statement-v1-product-dto.d.ts +2 -2
- package/dist/models/statement-v1-product-dto.js +2 -2
- package/dist/models/submit-negotiation-scores-v1-request-dto.d.ts +2 -2
- package/dist/models/submit-negotiation-scores-v1-request-dto.js +2 -2
- package/dist/models/supplier-card-payable-response-dto.d.ts +2 -2
- package/dist/models/supplier-card-payable-response-dto.js +2 -2
- package/dist/models/supplier-tax-type.d.ts +2 -2
- package/dist/models/supplier-tax-type.js +2 -2
- package/dist/models/token-request-dto.d.ts +2 -2
- package/dist/models/token-request-dto.js +2 -2
- package/dist/models/token-response-dto.d.ts +2 -2
- package/dist/models/token-response-dto.js +2 -2
- package/dist/models/update-bid-request-dto.d.ts +2 -2
- package/dist/models/update-bid-request-dto.js +2 -2
- package/dist/models/update-bid200-response.d.ts +21 -0
- package/dist/models/update-bid200-response.js +15 -0
- package/dist/models/update-webhook-endpoint-request-dto.d.ts +27 -0
- package/dist/models/update-webhook-endpoint-request-dto.js +15 -0
- package/dist/models/upload-file-request-dto.d.ts +2 -2
- package/dist/models/upload-file-request-dto.js +2 -2
- package/dist/models/upload-file-v1-request-dto.d.ts +2 -2
- package/dist/models/upload-file-v1-request-dto.js +2 -2
- package/dist/models/upload-file201-response.d.ts +21 -0
- package/dist/models/upload-file201-response.js +15 -0
- package/dist/models/webhook-delivery-dto.d.ts +73 -0
- package/dist/models/webhook-delivery-dto.js +24 -0
- package/dist/models/webhook-endpoint-dto.d.ts +55 -0
- package/dist/models/webhook-endpoint-dto.js +15 -0
- package/dist/models/webhook-endpoint-with-secret-dto.d.ts +59 -0
- package/dist/models/webhook-endpoint-with-secret-dto.js +15 -0
- package/dist/models/webhook-test-result-dto.d.ts +25 -0
- package/dist/models/webhook-test-result-dto.js +15 -0
- package/docs/AcceptanceStatusResponseDto.md +28 -0
- package/docs/AcknowledgeProductReceipt200Response.md +22 -0
- package/docs/AcknowledgeProductsRequestDto.md +20 -0
- package/docs/AuthorizationServerMetadataDto.md +2 -0
- package/docs/AwardRevertedV2ResponseDto.md +22 -0
- package/docs/BidCancelledResponseDto.md +22 -0
- package/docs/BidContactDto.md +24 -0
- package/docs/BidContactsDto.md +22 -0
- package/docs/BidContractDocumentDto.md +38 -0
- package/docs/BidDeliveryTermsDto.md +28 -0
- package/docs/BidPaymentTermsDto.md +22 -0
- package/docs/BidProductDto.md +30 -0
- package/docs/BidPublicStatus.md +0 -1
- package/docs/{IssueTaxInvoiceRequestDto.md β BidResultsBatchRequestDto.md} +5 -5
- package/docs/BidSummaryDto.md +16 -0
- package/docs/CancelBid200Response.md +22 -0
- package/docs/CancelBidRequestDto.md +20 -0
- package/docs/CompleteAcceptance200Response.md +22 -0
- package/docs/CompleteInvoice200Response.md +22 -0
- package/docs/CreateCardPayment200Response.md +22 -0
- package/docs/CreateWebhookEndpoint201Response.md +22 -0
- package/docs/CreateWebhookEndpointRequestDto.md +22 -0
- package/docs/FileMetaResponseDto.md +28 -0
- package/docs/GetBid200Response.md +22 -0
- package/docs/GetBidAcceptance200Response.md +22 -0
- package/docs/GetBidResults200Response.md +22 -0
- package/docs/GetBidSettlement200Response.md +22 -0
- package/docs/GetBidStatement200Response.md +22 -0
- package/docs/GetFileMeta200Response.md +22 -0
- package/docs/GetSupplierCardPayableV2200Response.md +22 -0
- package/docs/GetWebhookEndpoint200Response.md +22 -0
- package/docs/HealthControllerCheck200Response.md +22 -0
- package/docs/IntrospectRequestDto.md +30 -0
- package/docs/IntrospectionResponseDto.md +34 -0
- package/docs/ListBidContractDocuments200Response.md +22 -0
- package/docs/ListBidParticipants200Response.md +22 -0
- package/docs/ListBidResults200Response.md +22 -0
- package/docs/ListBids200Response.md +22 -0
- package/docs/ListProducts200Response.md +22 -0
- package/docs/ListWebhookDeliveries200Response.md +22 -0
- package/docs/ListWebhookDeliveriesResponseDto.md +22 -0
- package/docs/ListWebhookEndpoints200Response.md +22 -0
- package/docs/MarkBidFailed201Response.md +22 -0
- package/docs/OauthApi.md +54 -0
- package/docs/PartnerV1Api.md +12 -12
- package/docs/PartnerV2Api.md +1239 -225
- package/docs/PartnerWebhookDeliveryStatus.md +14 -0
- package/docs/PartnerWebhookEndpointStatus.md +11 -0
- package/docs/PartnerWebhookEventType.md +17 -0
- package/docs/ProblemDetailsDto.md +3 -1
- package/docs/ProductReceiptResponseDto.md +20 -0
- package/docs/ProductResponseDto.md +50 -0
- package/docs/PublishBid200Response.md +22 -0
- package/docs/RegenerateContractDocuments201Response.md +22 -0
- package/docs/RegisterAward201Response.md +22 -0
- package/docs/RegisterBid201Response.md +22 -0
- package/docs/RevertAward200Response.md +22 -0
- package/docs/RevertAwardRequestDto.md +20 -0
- package/docs/SendWebhookTestEvent200Response.md +22 -0
- package/docs/UpdateBid200Response.md +22 -0
- package/docs/UpdateWebhookEndpointRequestDto.md +24 -0
- package/docs/UploadFile201Response.md +22 -0
- package/docs/WebhookDeliveryDto.md +42 -0
- package/docs/WebhookEndpointDto.md +38 -0
- package/docs/WebhookEndpointWithSecretDto.md +40 -0
- package/docs/WebhookTestResultDto.md +24 -0
- package/index.ts +2 -2
- package/models/acceptance-result-response-dto.ts +2 -2
- package/models/acceptance-result-v1-response-dto.ts +2 -2
- package/models/acceptance-status-response-dto.ts +39 -0
- package/models/acknowledge-product-receipt200-response.ts +27 -0
- package/models/acknowledge-products-request-dto.ts +23 -0
- package/models/acknowledge-products-v1-request-dto.ts +2 -2
- package/models/authorization-server-metadata-dto.ts +6 -2
- package/models/award-method-public.ts +2 -2
- package/models/award-registered-response-dto.ts +2 -2
- package/models/award-registered-v2-response-dto.ts +2 -2
- package/models/award-reverted-v2-response-dto.ts +34 -0
- package/models/bid-attachment-v1-dto.ts +2 -2
- package/models/bid-bond-dto.ts +2 -2
- package/models/bid-bond-v1-dto.ts +2 -2
- package/models/bid-cancelled-response-dto.ts +34 -0
- package/models/bid-contact-dto.ts +31 -0
- package/models/bid-contacts-dto.ts +30 -0
- package/models/bid-contract-document-dto.ts +69 -0
- package/models/bid-contract-documents-batch-v1-request-dto.ts +2 -2
- package/models/bid-contract-documents-v1-response-dto.ts +2 -2
- package/models/bid-created-response-dto.ts +2 -2
- package/models/bid-delivery-terms-dto.ts +39 -0
- package/models/bid-detail-response-dto.ts +2 -2
- package/models/bid-document-dto.ts +2 -2
- package/models/bid-document-v1-dto.ts +2 -2
- package/models/bid-failed-response-dto.ts +2 -2
- package/models/bid-failed-v2-response-dto.ts +2 -2
- package/models/bid-failure-reason.ts +2 -2
- package/models/bid-item-dto.ts +2 -2
- package/models/bid-item-v1-dto.ts +2 -2
- package/models/bid-lifecycle-dto.ts +2 -2
- package/models/bid-manager-dto.ts +2 -2
- package/models/bid-manager-v1-dto.ts +2 -2
- package/models/bid-participant-summary-dto.ts +2 -2
- package/models/bid-payment-terms-dto.ts +27 -0
- package/models/bid-product-dto.ts +43 -0
- package/models/bid-public-status.ts +2 -5
- package/models/bid-published-response-dto.ts +2 -2
- package/models/bid-registered-response-dto.ts +2 -2
- package/models/bid-result-participant-attachment-dto.ts +2 -2
- package/models/bid-result-participant-dto.ts +2 -2
- package/models/bid-result-v1-attachment-dto.ts +2 -2
- package/models/bid-result-v1-bid-product-info-dto.ts +2 -2
- package/models/bid-result-v1-participant-dto.ts +2 -2
- package/models/bid-result-v1-product-dto.ts +2 -2
- package/models/bid-results-batch-request-dto.ts +23 -0
- package/models/bid-results-batch-v1-request-dto.ts +2 -2
- package/models/bid-results-response-dto.ts +2 -2
- package/models/bid-results-v1-response-dto.ts +2 -2
- package/models/bid-settlement-line-item-dto.ts +2 -2
- package/models/bid-settlement-participant-dto.ts +2 -2
- package/models/bid-settlement-response-dto.ts +2 -2
- package/models/bid-statement-response-dto.ts +2 -2
- package/models/bid-statement-v1-response-dto.ts +2 -2
- package/models/bid-status.ts +2 -2
- package/models/bid-summary-dto.ts +49 -2
- package/models/bid-updated-response-dto.ts +2 -2
- package/models/cancel-bid-request-dto.ts +23 -0
- package/models/cancel-bid200-response.ts +27 -0
- package/models/card-payment-request-response-dto.ts +2 -2
- package/models/complete-acceptance-request-dto.ts +2 -2
- package/models/complete-acceptance-v1-request-dto.ts +2 -2
- package/models/complete-acceptance200-response.ts +27 -0
- package/models/complete-invoice200-response.ts +27 -0
- package/models/contract-document-item-dto.ts +2 -2
- package/models/contract-documents-regenerated-response-dto.ts +2 -2
- package/models/contract-restriction-confirm-input-dto.ts +2 -2
- package/models/create-bid-request-dto.ts +2 -2
- package/models/create-bid-v1-request-dto.ts +2 -2
- package/models/create-card-payment-request-dto.ts +2 -2
- package/models/create-card-payment200-response.ts +27 -0
- package/models/create-external-contract-documents-request-dto.ts +2 -2
- package/models/create-external-contract-documents-response-dto.ts +2 -2
- package/models/create-webhook-endpoint-request-dto.ts +30 -0
- package/models/create-webhook-endpoint201-response.ts +27 -0
- package/models/external-contract-document-item-dto.ts +2 -2
- package/models/external-contract-documents-response-dto.ts +2 -2
- package/models/external-contract-item-dto.ts +2 -2
- package/models/external-contract-snapshot-dto.ts +2 -2
- package/models/external-document-inputs-dto.ts +2 -2
- package/models/file-meta-response-dto.ts +39 -0
- package/models/file-uploaded-response-dto.ts +2 -2
- package/models/file-uploaded-v1-response-dto.ts +2 -2
- package/models/generated-external-contract-document-dto.ts +2 -2
- package/models/get-bid-acceptance200-response.ts +27 -0
- package/models/get-bid-results200-response.ts +27 -0
- package/models/get-bid-settlement200-response.ts +27 -0
- package/models/get-bid-statement200-response.ts +27 -0
- package/models/get-bid200-response.ts +27 -0
- package/models/get-file-meta200-response.ts +27 -0
- package/models/get-supplier-card-payable-v2200-response.ts +27 -0
- package/models/get-webhook-endpoint200-response.ts +27 -0
- package/models/health-controller-check200-response.ts +27 -0
- package/models/health-response-dto.ts +2 -2
- package/models/hierarchical-region-dto.ts +2 -2
- package/models/hierarchical-region-v1-dto.ts +2 -2
- package/models/index.ts +59 -8
- package/models/introspect-request-dto.ts +56 -0
- package/models/introspection-response-dto.ts +51 -0
- package/models/invalid-param-dto.ts +2 -2
- package/models/invoice-completed-response-dto.ts +2 -2
- package/models/list-bid-contract-documents200-response.ts +27 -0
- package/models/list-bid-participants200-response.ts +27 -0
- package/models/list-bid-results200-response.ts +27 -0
- package/models/list-bids-response-dto.ts +2 -2
- package/models/list-bids200-response.ts +27 -0
- package/models/list-products200-response.ts +27 -0
- package/models/list-webhook-deliveries-response-dto.ts +30 -0
- package/models/list-webhook-deliveries200-response.ts +27 -0
- package/models/list-webhook-endpoints200-response.ts +27 -0
- package/models/mark-bid-failed-request-dto.ts +2 -2
- package/models/mark-bid-failed-v1-request-dto.ts +2 -2
- package/models/mark-bid-failed201-response.ts +27 -0
- package/models/negotiation-score-v1-dto.ts +2 -2
- package/models/negotiation-scored-response-dto.ts +2 -2
- package/models/oauth-error-response-dto.ts +2 -2
- package/models/partner-webhook-delivery-status.ts +28 -0
- package/models/partner-webhook-endpoint-status.ts +29 -0
- package/models/partner-webhook-event-type.ts +32 -0
- package/models/preconditions-dto.ts +2 -2
- package/models/preconditions-v1-dto.ts +2 -2
- package/models/problem-details-dto.ts +7 -3
- package/models/product-receipt-response-dto.ts +23 -0
- package/models/product-receipt-v1-response-dto.ts +2 -2
- package/models/product-response-dto.ts +83 -0
- package/models/product-v1-response-dto.ts +2 -2
- package/models/protected-resource-metadata-dto.ts +2 -2
- package/models/publish-bid200-response.ts +27 -0
- package/models/regenerate-contract-documents201-response.ts +27 -0
- package/models/register-award-request-dto.ts +2 -2
- package/models/register-award-v1-request-dto.ts +2 -2
- package/models/register-award201-response.ts +27 -0
- package/models/register-bid201-response.ts +27 -0
- package/models/register-semo-contract-request-dto.ts +2 -2
- package/models/request-split-invoice-v1-request-dto.ts +2 -2
- package/models/retiree-roster-input-dto.ts +2 -2
- package/models/retiree-roster-row-dto.ts +2 -2
- package/models/revert-award-request-dto.ts +23 -0
- package/models/revert-award200-response.ts +27 -0
- package/models/revoke-request-dto.ts +2 -2
- package/models/semo-contract-registered-response-dto.ts +2 -2
- package/models/semo-contract-taxinvoice-status-response-dto.ts +2 -2
- package/models/send-webhook-test-event200-response.ts +27 -0
- package/models/split-invoice-v1-response-dto.ts +2 -2
- package/models/statement-document-dto.ts +2 -2
- package/models/statement-product-dto.ts +2 -2
- package/models/statement-v1-document-dto.ts +2 -2
- package/models/statement-v1-product-dto.ts +2 -2
- package/models/submit-negotiation-scores-v1-request-dto.ts +2 -2
- package/models/supplier-card-payable-response-dto.ts +2 -2
- package/models/supplier-tax-type.ts +2 -2
- package/models/token-request-dto.ts +2 -2
- package/models/token-response-dto.ts +2 -2
- package/models/update-bid-request-dto.ts +2 -2
- package/models/update-bid200-response.ts +27 -0
- package/models/update-webhook-endpoint-request-dto.ts +39 -0
- package/models/upload-file-request-dto.ts +2 -2
- package/models/upload-file-v1-request-dto.ts +2 -2
- package/models/upload-file201-response.ts +27 -0
- package/models/webhook-delivery-dto.ts +82 -0
- package/models/webhook-endpoint-dto.ts +67 -0
- package/models/webhook-endpoint-with-secret-dto.ts +71 -0
- package/models/webhook-test-result-dto.ts +31 -0
- package/package.json +1 -1
- package/dist/esm/models/close-sandbox-bid-response-dto.d.ts +0 -34
- package/dist/esm/models/close-sandbox-bid-response-dto.js +0 -21
- package/dist/esm/models/embed-launch-request-dto.d.ts +0 -33
- package/dist/esm/models/embed-launch-request-dto.js +0 -20
- package/dist/esm/models/embed-launch-response-dto.d.ts +0 -21
- package/dist/esm/models/embed-launch-response-dto.js +0 -14
- package/dist/esm/models/issue-tax-invoice-request-dto.d.ts +0 -17
- package/dist/esm/models/issue-tax-invoice-request-dto.js +0 -14
- package/dist/esm/models/negotiation-score-dto.d.ts +0 -25
- package/dist/esm/models/negotiation-score-dto.js +0 -14
- package/dist/esm/models/negotiation-scored-v2-response-dto.d.ts +0 -29
- package/dist/esm/models/negotiation-scored-v2-response-dto.js +0 -16
- package/dist/esm/models/submit-negotiation-scores-request-dto.d.ts +0 -22
- package/dist/esm/models/submit-negotiation-scores-request-dto.js +0 -14
- package/dist/esm/models/tax-invoice-issued-response-dto.d.ts +0 -33
- package/dist/esm/models/tax-invoice-issued-response-dto.js +0 -14
- package/dist/models/close-sandbox-bid-response-dto.d.ts +0 -34
- package/dist/models/close-sandbox-bid-response-dto.js +0 -24
- package/dist/models/embed-launch-request-dto.d.ts +0 -33
- package/dist/models/embed-launch-request-dto.js +0 -23
- package/dist/models/embed-launch-response-dto.d.ts +0 -21
- package/dist/models/embed-launch-response-dto.js +0 -15
- package/dist/models/issue-tax-invoice-request-dto.d.ts +0 -17
- package/dist/models/issue-tax-invoice-request-dto.js +0 -15
- package/dist/models/negotiation-score-dto.d.ts +0 -25
- package/dist/models/negotiation-score-dto.js +0 -15
- package/dist/models/negotiation-scored-v2-response-dto.d.ts +0 -29
- package/dist/models/negotiation-scored-v2-response-dto.js +0 -19
- package/dist/models/submit-negotiation-scores-request-dto.d.ts +0 -22
- package/dist/models/submit-negotiation-scores-request-dto.js +0 -15
- package/dist/models/tax-invoice-issued-response-dto.d.ts +0 -33
- package/dist/models/tax-invoice-issued-response-dto.js +0 -15
- package/docs/CloseSandboxBidResponseDto.md +0 -24
- package/docs/EmbedLaunchRequestDto.md +0 -24
- package/docs/EmbedLaunchResponseDto.md +0 -22
- package/docs/NegotiationScoreDto.md +0 -24
- package/docs/NegotiationScoredV2ResponseDto.md +0 -24
- package/docs/SubmitNegotiationScoresRequestDto.md +0 -22
- package/docs/TaxInvoiceIssuedResponseDto.md +0 -28
- package/models/close-sandbox-bid-response-dto.ts +0 -43
- package/models/embed-launch-request-dto.ts +0 -42
- package/models/embed-launch-response-dto.ts +0 -27
- package/models/issue-tax-invoice-request-dto.ts +0 -23
- package/models/negotiation-score-dto.ts +0 -31
- package/models/negotiation-scored-v2-response-dto.ts +0 -38
- package/models/submit-negotiation-scores-request-dto.ts +0 -30
- package/models/tax-invoice-issued-response-dto.ts +0 -39
package/api/well-known-api.ts
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
/* eslint-disable */
|
|
3
3
|
/**
|
|
4
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`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `
|
|
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 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ μ
μ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , `/v1/_*` μ λκ²°λ λ κ±°μ νλ©΄μ΄λ©°, νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. νΈμΆ νμ μ체λ₯Ό μ€μ΄λ €λ©΄ μΉν
μ μ¬μ©νμΈμ. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**λ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μλλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μΈ κ². slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ λͺ
μλΌ μλ€. μ slug μ μΆκ°λ μ μμΌλ―λ‘, λͺ¨λ₯΄λ slug μ λ§λλ©΄ `type` μ΄ μλλΌ **HTTP status λ‘ ν΄λ°±**νλλ‘ κ΅¬νν κ². ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ΄λ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨λ€. μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ릴 κ². ## λ μ΄νΈ λ¦¬λ° μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ**. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μΈ κ². - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§νλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ νλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλν κ². ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈνλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦°λ€. ## λ²μ μλͺ
(deprecation/sunset) - **_/v1** μ λ κ±°μ V5 cutover μλ£ μμ κΉμ§ μ μ§λλ μΆ©μ€ νλ‘μμ
λλ€. νμ§ μΌμ μ΄ μ ν΄μ§λ©΄ /v1 μλ΅μ ν€λ μΈ κ°κ° μ€λ¦½λλ€ β `Deprecation`(RFC 9745, `@<epochμ΄>`) Β· `Sunset`(RFC 8594, HTTP-date) Β· `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` β μ΄μ μλ΄ λ¬Έμλ₯Ό κ°λ¦¬ν΅λλ€). μΌμ μ΄ μ ν΄μ§κΈ° μ μλ μ
λ€ λκ°μ§ μμ΅λλ€. μ’
λ£μΌμ΄ μ§λ λ€μ νΈμΆμ `404` κ° μλλΌ **`410 Gone`** κ³Ό `type: β¦/endpoint-sunset` μΌλ‘ κ±°μ λ©λλ€. λμ λ»μ΄ λ€λ¦
λλ€ β `404` λ \"κ·Έλ° κ²μ΄ μμλμ§ λͺ¨λ₯΄κ² λ€\", `410` μ \"μμκ³ μλμ μΌλ‘ μμ΄λ€\" μ
λλ€. `410` μ λ°μΌλ©΄ κ²½λ‘ μ€νλ₯Ό μμ¬νμ§ λ§κ³ /v2 λ‘ μ΄μ νμΈμ. - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§νλ€. μλΉμλ μ΄ ν€λλ₯Ό λͺ¨λν°λ§ν κ².
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document:
|
|
7
|
+
* The version of the OpenAPI document: 31.1.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).
|
package/api.ts
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
/* eslint-disable */
|
|
3
3
|
/**
|
|
4
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`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `
|
|
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 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ μ
μ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , `/v1/_*` μ λκ²°λ λ κ±°μ νλ©΄μ΄λ©°, νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. νΈμΆ νμ μ체λ₯Ό μ€μ΄λ €λ©΄ μΉν
μ μ¬μ©νμΈμ. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**λ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μλλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μΈ κ². slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ λͺ
μλΌ μλ€. μ slug μ μΆκ°λ μ μμΌλ―λ‘, λͺ¨λ₯΄λ slug μ λ§λλ©΄ `type` μ΄ μλλΌ **HTTP status λ‘ ν΄λ°±**νλλ‘ κ΅¬νν κ². ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ΄λ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨λ€. μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ릴 κ². ## λ μ΄νΈ λ¦¬λ° μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ**. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μΈ κ². - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§νλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ νλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλν κ². ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈνλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦°λ€. ## λ²μ μλͺ
(deprecation/sunset) - **_/v1** μ λ κ±°μ V5 cutover μλ£ μμ κΉμ§ μ μ§λλ μΆ©μ€ νλ‘μμ
λλ€. νμ§ μΌμ μ΄ μ ν΄μ§λ©΄ /v1 μλ΅μ ν€λ μΈ κ°κ° μ€λ¦½λλ€ β `Deprecation`(RFC 9745, `@<epochμ΄>`) Β· `Sunset`(RFC 8594, HTTP-date) Β· `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` β μ΄μ μλ΄ λ¬Έμλ₯Ό κ°λ¦¬ν΅λλ€). μΌμ μ΄ μ ν΄μ§κΈ° μ μλ μ
λ€ λκ°μ§ μμ΅λλ€. μ’
λ£μΌμ΄ μ§λ λ€μ νΈμΆμ `404` κ° μλλΌ **`410 Gone`** κ³Ό `type: β¦/endpoint-sunset` μΌλ‘ κ±°μ λ©λλ€. λμ λ»μ΄ λ€λ¦
λλ€ β `404` λ \"κ·Έλ° κ²μ΄ μμλμ§ λͺ¨λ₯΄κ² λ€\", `410` μ \"μμκ³ μλμ μΌλ‘ μμ΄λ€\" μ
λλ€. `410` μ λ°μΌλ©΄ κ²½λ‘ μ€νλ₯Ό μμ¬νμ§ λ§κ³ /v2 λ‘ μ΄μ νμΈμ. - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§νλ€. μλΉμλ μ΄ ν€λλ₯Ό λͺ¨λν°λ§ν κ².
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document:
|
|
7
|
+
* The version of the OpenAPI document: 31.1.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).
|
package/base.ts
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
/* eslint-disable */
|
|
3
3
|
/**
|
|
4
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`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `
|
|
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 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ μ
μ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , `/v1/_*` μ λκ²°λ λ κ±°μ νλ©΄μ΄λ©°, νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. νΈμΆ νμ μ체λ₯Ό μ€μ΄λ €λ©΄ μΉν
μ μ¬μ©νμΈμ. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**λ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μλλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μΈ κ². slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ λͺ
μλΌ μλ€. μ slug μ μΆκ°λ μ μμΌλ―λ‘, λͺ¨λ₯΄λ slug μ λ§λλ©΄ `type` μ΄ μλλΌ **HTTP status λ‘ ν΄λ°±**νλλ‘ κ΅¬νν κ². ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ΄λ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨λ€. μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ릴 κ². ## λ μ΄νΈ λ¦¬λ° μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ**. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μΈ κ². - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§νλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ νλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλν κ². ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈνλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦°λ€. ## λ²μ μλͺ
(deprecation/sunset) - **_/v1** μ λ κ±°μ V5 cutover μλ£ μμ κΉμ§ μ μ§λλ μΆ©μ€ νλ‘μμ
λλ€. νμ§ μΌμ μ΄ μ ν΄μ§λ©΄ /v1 μλ΅μ ν€λ μΈ κ°κ° μ€λ¦½λλ€ β `Deprecation`(RFC 9745, `@<epochμ΄>`) Β· `Sunset`(RFC 8594, HTTP-date) Β· `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` β μ΄μ μλ΄ λ¬Έμλ₯Ό κ°λ¦¬ν΅λλ€). μΌμ μ΄ μ ν΄μ§κΈ° μ μλ μ
λ€ λκ°μ§ μμ΅λλ€. μ’
λ£μΌμ΄ μ§λ λ€μ νΈμΆμ `404` κ° μλλΌ **`410 Gone`** κ³Ό `type: β¦/endpoint-sunset` μΌλ‘ κ±°μ λ©λλ€. λμ λ»μ΄ λ€λ¦
λλ€ β `404` λ \"κ·Έλ° κ²μ΄ μμλμ§ λͺ¨λ₯΄κ² λ€\", `410` μ \"μμκ³ μλμ μΌλ‘ μμ΄λ€\" μ
λλ€. `410` μ λ°μΌλ©΄ κ²½λ‘ μ€νλ₯Ό μμ¬νμ§ λ§κ³ /v2 λ‘ μ΄μ νμΈμ. - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§νλ€. μλΉμλ μ΄ ν€λλ₯Ό λͺ¨λν°λ§ν κ².
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document:
|
|
7
|
+
* The version of the OpenAPI document: 31.1.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).
|
package/common.ts
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
/* eslint-disable */
|
|
3
3
|
/**
|
|
4
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`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `
|
|
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 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ μ
μ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , `/v1/_*` μ λκ²°λ λ κ±°μ νλ©΄μ΄λ©°, νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. νΈμΆ νμ μ체λ₯Ό μ€μ΄λ €λ©΄ μΉν
μ μ¬μ©νμΈμ. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**λ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μλλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μΈ κ². slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ λͺ
μλΌ μλ€. μ slug μ μΆκ°λ μ μμΌλ―λ‘, λͺ¨λ₯΄λ slug μ λ§λλ©΄ `type` μ΄ μλλΌ **HTTP status λ‘ ν΄λ°±**νλλ‘ κ΅¬νν κ². ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ΄λ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨λ€. μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ릴 κ². ## λ μ΄νΈ λ¦¬λ° μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ**. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μΈ κ². - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§νλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ νλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλν κ². ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈνλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦°λ€. ## λ²μ μλͺ
(deprecation/sunset) - **_/v1** μ λ κ±°μ V5 cutover μλ£ μμ κΉμ§ μ μ§λλ μΆ©μ€ νλ‘μμ
λλ€. νμ§ μΌμ μ΄ μ ν΄μ§λ©΄ /v1 μλ΅μ ν€λ μΈ κ°κ° μ€λ¦½λλ€ β `Deprecation`(RFC 9745, `@<epochμ΄>`) Β· `Sunset`(RFC 8594, HTTP-date) Β· `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` β μ΄μ μλ΄ λ¬Έμλ₯Ό κ°λ¦¬ν΅λλ€). μΌμ μ΄ μ ν΄μ§κΈ° μ μλ μ
λ€ λκ°μ§ μμ΅λλ€. μ’
λ£μΌμ΄ μ§λ λ€μ νΈμΆμ `404` κ° μλλΌ **`410 Gone`** κ³Ό `type: β¦/endpoint-sunset` μΌλ‘ κ±°μ λ©λλ€. λμ λ»μ΄ λ€λ¦
λλ€ β `404` λ \"κ·Έλ° κ²μ΄ μμλμ§ λͺ¨λ₯΄κ² λ€\", `410` μ \"μμκ³ μλμ μΌλ‘ μμ΄λ€\" μ
λλ€. `410` μ λ°μΌλ©΄ κ²½λ‘ μ€νλ₯Ό μμ¬νμ§ λ§κ³ /v2 λ‘ μ΄μ νμΈμ. - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§νλ€. μλΉμλ μ΄ ν€λλ₯Ό λͺ¨λν°λ§ν κ².
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document:
|
|
7
|
+
* The version of the OpenAPI document: 31.1.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).
|
package/configuration.ts
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
/* tslint:disable */
|
|
2
2
|
/**
|
|
3
3
|
* CMARKET V6 Partner API
|
|
4
|
-
* μΈλΆ 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`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `
|
|
4
|
+
* μΈλΆ ERP μ°λμ© RESTful API. ## λ²μ λ³ μΈμ¦ - **_/v2** β OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν° λ°κΈ ν `Authorization: Bearer <token>` ν€λ. - **_/v1** β V5 μΆ©μ€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν€λλ‘ μ μ‘. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆν κ². - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μλλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ μ
μ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , `/v1/_*` μ λκ²°λ λ κ±°μ νλ©΄μ΄λ©°, νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. νΈμΆ νμ μ체λ₯Ό μ€μ΄λ €λ©΄ μΉν
μ μ¬μ©νμΈμ. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**λ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μλλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μΈ κ². slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ λͺ
μλΌ μλ€. μ slug μ μΆκ°λ μ μμΌλ―λ‘, λͺ¨λ₯΄λ slug μ λ§λλ©΄ `type` μ΄ μλλΌ **HTTP status λ‘ ν΄λ°±**νλλ‘ κ΅¬νν κ². ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ΄λ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨λ€. μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ릴 κ². ## λ μ΄νΈ λ¦¬λ° μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ**. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μΈ κ². - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§νλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ νλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλν κ². ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈνλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦°λ€. ## λ²μ μλͺ
(deprecation/sunset) - **_/v1** μ λ κ±°μ V5 cutover μλ£ μμ κΉμ§ μ μ§λλ μΆ©μ€ νλ‘μμ
λλ€. νμ§ μΌμ μ΄ μ ν΄μ§λ©΄ /v1 μλ΅μ ν€λ μΈ κ°κ° μ€λ¦½λλ€ β `Deprecation`(RFC 9745, `@<epochμ΄>`) Β· `Sunset`(RFC 8594, HTTP-date) Β· `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` β μ΄μ μλ΄ λ¬Έμλ₯Ό κ°λ¦¬ν΅λλ€). μΌμ μ΄ μ ν΄μ§κΈ° μ μλ μ
λ€ λκ°μ§ μμ΅λλ€. μ’
λ£μΌμ΄ μ§λ λ€μ νΈμΆμ `404` κ° μλλΌ **`410 Gone`** κ³Ό `type: β¦/endpoint-sunset` μΌλ‘ κ±°μ λ©λλ€. λμ λ»μ΄ λ€λ¦
λλ€ β `404` λ \"κ·Έλ° κ²μ΄ μμλμ§ λͺ¨λ₯΄κ² λ€\", `410` μ \"μμκ³ μλμ μΌλ‘ μμ΄λ€\" μ
λλ€. `410` μ λ°μΌλ©΄ κ²½λ‘ μ€νλ₯Ό μμ¬νμ§ λ§κ³ /v2 λ‘ μ΄μ νμΈμ. - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§νλ€. μλΉμλ μ΄ ν€λλ₯Ό λͺ¨λν°λ§ν κ².
|
|
5
5
|
*
|
|
6
|
-
* The version of the OpenAPI document:
|
|
6
|
+
* The version of the OpenAPI document: 31.1.0
|
|
7
7
|
* Contact: semo.io.kr@gmail.com
|
|
8
8
|
*
|
|
9
9
|
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
package/dist/api/oauth-api.d.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* CMARKET V6 Partner API
|
|
3
|
-
* μΈλΆ ERP μ°λμ© RESTful API. ## λ²μ λ³ μΈμ¦ - **_/v2** β OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν° λ°κΈ ν `Authorization: Bearer <token>` ν€λ. - **_/v1** β V5 μΆ©μ€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν€λλ‘ μ μ‘. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆν κ². - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μλλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `
|
|
3
|
+
* μΈλΆ ERP μ°λμ© RESTful API. ## λ²μ λ³ μΈμ¦ - **_/v2** β OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν° λ°κΈ ν `Authorization: Bearer <token>` ν€λ. - **_/v1** β V5 μΆ©μ€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν€λλ‘ μ μ‘. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆν κ². - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μλλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ μ
μ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , `/v1/_*` μ λκ²°λ λ κ±°μ νλ©΄μ΄λ©°, νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. νΈμΆ νμ μ체λ₯Ό μ€μ΄λ €λ©΄ μΉν
μ μ¬μ©νμΈμ. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**λ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μλλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μΈ κ². slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ λͺ
μλΌ μλ€. μ slug μ μΆκ°λ μ μμΌλ―λ‘, λͺ¨λ₯΄λ slug μ λ§λλ©΄ `type` μ΄ μλλΌ **HTTP status λ‘ ν΄λ°±**νλλ‘ κ΅¬νν κ². ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ΄λ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨λ€. μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ릴 κ². ## λ μ΄νΈ λ¦¬λ° μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ**. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μΈ κ². - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§νλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ νλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλν κ². ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈνλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦°λ€. ## λ²μ μλͺ
(deprecation/sunset) - **_/v1** μ λ κ±°μ V5 cutover μλ£ μμ κΉμ§ μ μ§λλ μΆ©μ€ νλ‘μμ
λλ€. νμ§ μΌμ μ΄ μ ν΄μ§λ©΄ /v1 μλ΅μ ν€λ μΈ κ°κ° μ€λ¦½λλ€ β `Deprecation`(RFC 9745, `@<epochμ΄>`) Β· `Sunset`(RFC 8594, HTTP-date) Β· `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` β μ΄μ μλ΄ λ¬Έμλ₯Ό κ°λ¦¬ν΅λλ€). μΌμ μ΄ μ ν΄μ§κΈ° μ μλ μ
λ€ λκ°μ§ μμ΅λλ€. μ’
λ£μΌμ΄ μ§λ λ€μ νΈμΆμ `404` κ° μλλΌ **`410 Gone`** κ³Ό `type: β¦/endpoint-sunset` μΌλ‘ κ±°μ λ©λλ€. λμ λ»μ΄ λ€λ¦
λλ€ β `404` λ \"κ·Έλ° κ²μ΄ μμλμ§ λͺ¨λ₯΄κ² λ€\", `410` μ \"μμκ³ μλμ μΌλ‘ μμ΄λ€\" μ
λλ€. `410` μ λ°μΌλ©΄ κ²½λ‘ μ€νλ₯Ό μμ¬νμ§ λ§κ³ /v2 λ‘ μ΄μ νμΈμ. - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§νλ€. μλΉμλ μ΄ ν€λλ₯Ό λͺ¨λν°λ§ν κ².
|
|
4
4
|
*
|
|
5
|
-
* The version of the OpenAPI document:
|
|
5
|
+
* The version of the OpenAPI document: 31.1.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).
|
|
@@ -12,6 +12,8 @@
|
|
|
12
12
|
import type { Configuration } from '../configuration';
|
|
13
13
|
import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
|
|
14
14
|
import { type RequestArgs, BaseAPI } from '../base';
|
|
15
|
+
import type { IntrospectRequestDto } from '../models';
|
|
16
|
+
import type { IntrospectionResponseDto } from '../models';
|
|
15
17
|
import type { RevokeRequestDto } from '../models';
|
|
16
18
|
import type { TokenRequestDto } from '../models';
|
|
17
19
|
import type { TokenResponseDto } from '../models';
|
|
@@ -19,6 +21,14 @@ import type { TokenResponseDto } from '../models';
|
|
|
19
21
|
* OauthApi - axios parameter creator
|
|
20
22
|
*/
|
|
21
23
|
export declare const OauthApiAxiosParamCreator: (configuration?: Configuration) => {
|
|
24
|
+
/**
|
|
25
|
+
* κ°μ§κ³ μλ access token μ΄ μ§κΈλ μ ν¨νμ§, μ΄λ€ μ€μ½νλ₯Ό κ°λμ§ νμΈν©λλ€. μκΈ° ν ν°λ§ μ‘°νν μ μμ΅λλ€ β μμ‘°Β·λ§λ£Β·νκΈ°λκ±°λ λ€λ₯Έ client μ ν ν°μ΄λ©΄ μ΄μ λ₯Ό ꡬλΆνμ§ μκ³ `{\"active\": false}` λ‘ λ΅ν©λλ€(RFC 7662 Β§4).
|
|
26
|
+
* @summary OAuth 2.0 ν ν° κ²μ¬ (Token Introspection, RFC 7662)
|
|
27
|
+
* @param {IntrospectRequestDto} introspectRequestDto
|
|
28
|
+
* @param {*} [options] Override http request option.
|
|
29
|
+
* @throws {RequiredError}
|
|
30
|
+
*/
|
|
31
|
+
introspect: (introspectRequestDto: IntrospectRequestDto, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
|
|
22
32
|
/**
|
|
23
33
|
* λ°κΈλ°μ access token μ μ¦μ 무ν¨νν©λλ€. μ μΆμ νμΈνμ λ TTL(15λΆ) λ§λ£λ₯Ό κΈ°λ€λ¦¬μ§ μκ³ λλ κ²½λ‘μ
λλ€. RFC 7009 Β§2.2 μ λ°λΌ μ΄λ―Έ λ§λ£λκ±°λ μ μ μλ ν ν°μ 보λ΄λ 200 μΌλ‘ μλ΅ν©λλ€.
|
|
24
34
|
* @summary OAuth 2.0 ν ν° νκΈ° (Token Revocation, RFC 7009)
|
|
@@ -40,6 +50,14 @@ export declare const OauthApiAxiosParamCreator: (configuration?: Configuration)
|
|
|
40
50
|
* OauthApi - functional programming interface
|
|
41
51
|
*/
|
|
42
52
|
export declare const OauthApiFp: (configuration?: Configuration) => {
|
|
53
|
+
/**
|
|
54
|
+
* κ°μ§κ³ μλ access token μ΄ μ§κΈλ μ ν¨νμ§, μ΄λ€ μ€μ½νλ₯Ό κ°λμ§ νμΈν©λλ€. μκΈ° ν ν°λ§ μ‘°νν μ μμ΅λλ€ β μμ‘°Β·λ§λ£Β·νκΈ°λκ±°λ λ€λ₯Έ client μ ν ν°μ΄λ©΄ μ΄μ λ₯Ό ꡬλΆνμ§ μκ³ `{\"active\": false}` λ‘ λ΅ν©λλ€(RFC 7662 Β§4).
|
|
55
|
+
* @summary OAuth 2.0 ν ν° κ²μ¬ (Token Introspection, RFC 7662)
|
|
56
|
+
* @param {IntrospectRequestDto} introspectRequestDto
|
|
57
|
+
* @param {*} [options] Override http request option.
|
|
58
|
+
* @throws {RequiredError}
|
|
59
|
+
*/
|
|
60
|
+
introspect(introspectRequestDto: IntrospectRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<IntrospectionResponseDto>>;
|
|
43
61
|
/**
|
|
44
62
|
* λ°κΈλ°μ access token μ μ¦μ 무ν¨νν©λλ€. μ μΆμ νμΈνμ λ TTL(15λΆ) λ§λ£λ₯Ό κΈ°λ€λ¦¬μ§ μκ³ λλ κ²½λ‘μ
λλ€. RFC 7009 Β§2.2 μ λ°λΌ μ΄λ―Έ λ§λ£λκ±°λ μ μ μλ ν ν°μ 보λ΄λ 200 μΌλ‘ μλ΅ν©λλ€.
|
|
45
63
|
* @summary OAuth 2.0 ν ν° νκΈ° (Token Revocation, RFC 7009)
|
|
@@ -61,6 +79,14 @@ export declare const OauthApiFp: (configuration?: Configuration) => {
|
|
|
61
79
|
* OauthApi - factory interface
|
|
62
80
|
*/
|
|
63
81
|
export declare const OauthApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
|
|
82
|
+
/**
|
|
83
|
+
* κ°μ§κ³ μλ access token μ΄ μ§κΈλ μ ν¨νμ§, μ΄λ€ μ€μ½νλ₯Ό κ°λμ§ νμΈν©λλ€. μκΈ° ν ν°λ§ μ‘°νν μ μμ΅λλ€ β μμ‘°Β·λ§λ£Β·νκΈ°λκ±°λ λ€λ₯Έ client μ ν ν°μ΄λ©΄ μ΄μ λ₯Ό ꡬλΆνμ§ μκ³ `{\"active\": false}` λ‘ λ΅ν©λλ€(RFC 7662 Β§4).
|
|
84
|
+
* @summary OAuth 2.0 ν ν° κ²μ¬ (Token Introspection, RFC 7662)
|
|
85
|
+
* @param {IntrospectRequestDto} introspectRequestDto
|
|
86
|
+
* @param {*} [options] Override http request option.
|
|
87
|
+
* @throws {RequiredError}
|
|
88
|
+
*/
|
|
89
|
+
introspect(introspectRequestDto: IntrospectRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<IntrospectionResponseDto>;
|
|
64
90
|
/**
|
|
65
91
|
* λ°κΈλ°μ access token μ μ¦μ 무ν¨νν©λλ€. μ μΆμ νμΈνμ λ TTL(15λΆ) λ§λ£λ₯Ό κΈ°λ€λ¦¬μ§ μκ³ λλ κ²½λ‘μ
λλ€. RFC 7009 Β§2.2 μ λ°λΌ μ΄λ―Έ λ§λ£λκ±°λ μ μ μλ ν ν°μ 보λ΄λ 200 μΌλ‘ μλ΅ν©λλ€.
|
|
66
92
|
* @summary OAuth 2.0 ν ν° νκΈ° (Token Revocation, RFC 7009)
|
|
@@ -82,6 +108,14 @@ export declare const OauthApiFactory: (configuration?: Configuration, basePath?:
|
|
|
82
108
|
* OauthApi - object-oriented interface
|
|
83
109
|
*/
|
|
84
110
|
export declare class OauthApi extends BaseAPI {
|
|
111
|
+
/**
|
|
112
|
+
* κ°μ§κ³ μλ access token μ΄ μ§κΈλ μ ν¨νμ§, μ΄λ€ μ€μ½νλ₯Ό κ°λμ§ νμΈν©λλ€. μκΈ° ν ν°λ§ μ‘°νν μ μμ΅λλ€ β μμ‘°Β·λ§λ£Β·νκΈ°λκ±°λ λ€λ₯Έ client μ ν ν°μ΄λ©΄ μ΄μ λ₯Ό ꡬλΆνμ§ μκ³ `{\"active\": false}` λ‘ λ΅ν©λλ€(RFC 7662 Β§4).
|
|
113
|
+
* @summary OAuth 2.0 ν ν° κ²μ¬ (Token Introspection, RFC 7662)
|
|
114
|
+
* @param {IntrospectRequestDto} introspectRequestDto
|
|
115
|
+
* @param {*} [options] Override http request option.
|
|
116
|
+
* @throws {RequiredError}
|
|
117
|
+
*/
|
|
118
|
+
introspect(introspectRequestDto: IntrospectRequestDto, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<IntrospectionResponseDto, any, {}>>;
|
|
85
119
|
/**
|
|
86
120
|
* λ°κΈλ°μ access token μ μ¦μ 무ν¨νν©λλ€. μ μΆμ νμΈνμ λ TTL(15λΆ) λ§λ£λ₯Ό κΈ°λ€λ¦¬μ§ μκ³ λλ κ²½λ‘μ
λλ€. RFC 7009 Β§2.2 μ λ°λΌ μ΄λ―Έ λ§λ£λκ±°λ μ μ μλ ν ν°μ 보λ΄λ 200 μΌλ‘ μλ΅ν©λλ€.
|
|
87
121
|
* @summary OAuth 2.0 ν ν° νκΈ° (Token Revocation, RFC 7009)
|
package/dist/api/oauth-api.js
CHANGED
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
/* eslint-disable */
|
|
4
4
|
/**
|
|
5
5
|
* CMARKET V6 Partner API
|
|
6
|
-
* μΈλΆ ERP μ°λμ© RESTful API. ## λ²μ λ³ μΈμ¦ - **_/v2** β OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν° λ°κΈ ν `Authorization: Bearer <token>` ν€λ. - **_/v1** β V5 μΆ©μ€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν€λλ‘ μ μ‘. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆν κ². - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μλλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `
|
|
6
|
+
* μΈλΆ ERP μ°λμ© RESTful API. ## λ²μ λ³ μΈμ¦ - **_/v2** β OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν° λ°κΈ ν `Authorization: Bearer <token>` ν€λ. - **_/v1** β V5 μΆ©μ€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν€λλ‘ μ μ‘. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆν κ². - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μλλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ μ
μ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , `/v1/_*` μ λκ²°λ λ κ±°μ νλ©΄μ΄λ©°, νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. νΈμΆ νμ μ체λ₯Ό μ€μ΄λ €λ©΄ μΉν
μ μ¬μ©νμΈμ. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**λ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μλλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μΈ κ². slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ λͺ
μλΌ μλ€. μ slug μ μΆκ°λ μ μμΌλ―λ‘, λͺ¨λ₯΄λ slug μ λ§λλ©΄ `type` μ΄ μλλΌ **HTTP status λ‘ ν΄λ°±**νλλ‘ κ΅¬νν κ². ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ΄λ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨λ€. μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ릴 κ². ## λ μ΄νΈ λ¦¬λ° μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ**. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μΈ κ². - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§νλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ νλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλν κ². ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈνλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦°λ€. ## λ²μ μλͺ
(deprecation/sunset) - **_/v1** μ λ κ±°μ V5 cutover μλ£ μμ κΉμ§ μ μ§λλ μΆ©μ€ νλ‘μμ
λλ€. νμ§ μΌμ μ΄ μ ν΄μ§λ©΄ /v1 μλ΅μ ν€λ μΈ κ°κ° μ€λ¦½λλ€ β `Deprecation`(RFC 9745, `@<epochμ΄>`) Β· `Sunset`(RFC 8594, HTTP-date) Β· `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` β μ΄μ μλ΄ λ¬Έμλ₯Ό κ°λ¦¬ν΅λλ€). μΌμ μ΄ μ ν΄μ§κΈ° μ μλ μ
λ€ λκ°μ§ μμ΅λλ€. μ’
λ£μΌμ΄ μ§λ λ€μ νΈμΆμ `404` κ° μλλΌ **`410 Gone`** κ³Ό `type: β¦/endpoint-sunset` μΌλ‘ κ±°μ λ©λλ€. λμ λ»μ΄ λ€λ¦
λλ€ β `404` λ \"κ·Έλ° κ²μ΄ μμλμ§ λͺ¨λ₯΄κ² λ€\", `410` μ \"μμκ³ μλμ μΌλ‘ μμ΄λ€\" μ
λλ€. `410` μ λ°μΌλ©΄ κ²½λ‘ μ€νλ₯Ό μμ¬νμ§ λ§κ³ /v2 λ‘ μ΄μ νμΈμ. - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§νλ€. μλΉμλ μ΄ ν€λλ₯Ό λͺ¨λν°λ§ν κ².
|
|
7
7
|
*
|
|
8
|
-
* The version of the OpenAPI document:
|
|
8
|
+
* The version of the OpenAPI document: 31.1.0
|
|
9
9
|
* Contact: semo.io.kr@gmail.com
|
|
10
10
|
*
|
|
11
11
|
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
@@ -34,6 +34,37 @@ const base_1 = require("../base");
|
|
|
34
34
|
*/
|
|
35
35
|
const OauthApiAxiosParamCreator = function (configuration) {
|
|
36
36
|
return {
|
|
37
|
+
/**
|
|
38
|
+
* κ°μ§κ³ μλ access token μ΄ μ§κΈλ μ ν¨νμ§, μ΄λ€ μ€μ½νλ₯Ό κ°λμ§ νμΈν©λλ€. μκΈ° ν ν°λ§ μ‘°νν μ μμ΅λλ€ β μμ‘°Β·λ§λ£Β·νκΈ°λκ±°λ λ€λ₯Έ client μ ν ν°μ΄λ©΄ μ΄μ λ₯Ό ꡬλΆνμ§ μκ³ `{\"active\": false}` λ‘ λ΅ν©λλ€(RFC 7662 Β§4).
|
|
39
|
+
* @summary OAuth 2.0 ν ν° κ²μ¬ (Token Introspection, RFC 7662)
|
|
40
|
+
* @param {IntrospectRequestDto} introspectRequestDto
|
|
41
|
+
* @param {*} [options] Override http request option.
|
|
42
|
+
* @throws {RequiredError}
|
|
43
|
+
*/
|
|
44
|
+
introspect: (introspectRequestDto_1, ...args_1) => __awaiter(this, [introspectRequestDto_1, ...args_1], void 0, function* (introspectRequestDto, options = {}) {
|
|
45
|
+
// verify required parameter 'introspectRequestDto' is not null or undefined
|
|
46
|
+
(0, common_1.assertParamExists)('introspect', 'introspectRequestDto', introspectRequestDto);
|
|
47
|
+
const localVarPath = `/oauth/introspect`;
|
|
48
|
+
// use dummy base URL string because the URL constructor only accepts absolute URLs.
|
|
49
|
+
const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
|
|
50
|
+
let baseOptions;
|
|
51
|
+
if (configuration) {
|
|
52
|
+
baseOptions = configuration.baseOptions;
|
|
53
|
+
}
|
|
54
|
+
const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
|
|
55
|
+
const localVarHeaderParameter = {};
|
|
56
|
+
const localVarQueryParameter = {};
|
|
57
|
+
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
58
|
+
localVarHeaderParameter['Accept'] = 'application/json';
|
|
59
|
+
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
60
|
+
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
61
|
+
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
62
|
+
localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(introspectRequestDto, localVarRequestOptions, configuration);
|
|
63
|
+
return {
|
|
64
|
+
url: (0, common_1.toPathString)(localVarUrlObj),
|
|
65
|
+
options: localVarRequestOptions,
|
|
66
|
+
};
|
|
67
|
+
}),
|
|
37
68
|
/**
|
|
38
69
|
* λ°κΈλ°μ access token μ μ¦μ 무ν¨νν©λλ€. μ μΆμ νμΈνμ λ TTL(15λΆ) λ§λ£λ₯Ό κΈ°λ€λ¦¬μ§ μκ³ λλ κ²½λ‘μ
λλ€. RFC 7009 Β§2.2 μ λ°λΌ μ΄λ―Έ λ§λ£λκ±°λ μ μ μλ ν ν°μ 보λ΄λ 200 μΌλ‘ μλ΅ν©λλ€.
|
|
39
70
|
* @summary OAuth 2.0 ν ν° νκΈ° (Token Revocation, RFC 7009)
|
|
@@ -105,6 +136,22 @@ exports.OauthApiAxiosParamCreator = OauthApiAxiosParamCreator;
|
|
|
105
136
|
const OauthApiFp = function (configuration) {
|
|
106
137
|
const localVarAxiosParamCreator = (0, exports.OauthApiAxiosParamCreator)(configuration);
|
|
107
138
|
return {
|
|
139
|
+
/**
|
|
140
|
+
* κ°μ§κ³ μλ access token μ΄ μ§κΈλ μ ν¨νμ§, μ΄λ€ μ€μ½νλ₯Ό κ°λμ§ νμΈν©λλ€. μκΈ° ν ν°λ§ μ‘°νν μ μμ΅λλ€ β μμ‘°Β·λ§λ£Β·νκΈ°λκ±°λ λ€λ₯Έ client μ ν ν°μ΄λ©΄ μ΄μ λ₯Ό ꡬλΆνμ§ μκ³ `{\"active\": false}` λ‘ λ΅ν©λλ€(RFC 7662 Β§4).
|
|
141
|
+
* @summary OAuth 2.0 ν ν° κ²μ¬ (Token Introspection, RFC 7662)
|
|
142
|
+
* @param {IntrospectRequestDto} introspectRequestDto
|
|
143
|
+
* @param {*} [options] Override http request option.
|
|
144
|
+
* @throws {RequiredError}
|
|
145
|
+
*/
|
|
146
|
+
introspect(introspectRequestDto, options) {
|
|
147
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
148
|
+
var _a, _b, _c;
|
|
149
|
+
const localVarAxiosArgs = yield localVarAxiosParamCreator.introspect(introspectRequestDto, options);
|
|
150
|
+
const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
|
|
151
|
+
const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['OauthApi.introspect']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
|
|
152
|
+
return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
|
|
153
|
+
});
|
|
154
|
+
},
|
|
108
155
|
/**
|
|
109
156
|
* λ°κΈλ°μ access token μ μ¦μ 무ν¨νν©λλ€. μ μΆμ νμΈνμ λ TTL(15λΆ) λ§λ£λ₯Ό κΈ°λ€λ¦¬μ§ μκ³ λλ κ²½λ‘μ
λλ€. RFC 7009 Β§2.2 μ λ°λΌ μ΄λ―Έ λ§λ£λκ±°λ μ μ μλ ν ν°μ 보λ΄λ 200 μΌλ‘ μλ΅ν©λλ€.
|
|
110
157
|
* @summary OAuth 2.0 ν ν° νκΈ° (Token Revocation, RFC 7009)
|
|
@@ -146,6 +193,16 @@ exports.OauthApiFp = OauthApiFp;
|
|
|
146
193
|
const OauthApiFactory = function (configuration, basePath, axios) {
|
|
147
194
|
const localVarFp = (0, exports.OauthApiFp)(configuration);
|
|
148
195
|
return {
|
|
196
|
+
/**
|
|
197
|
+
* κ°μ§κ³ μλ access token μ΄ μ§κΈλ μ ν¨νμ§, μ΄λ€ μ€μ½νλ₯Ό κ°λμ§ νμΈν©λλ€. μκΈ° ν ν°λ§ μ‘°νν μ μμ΅λλ€ β μμ‘°Β·λ§λ£Β·νκΈ°λκ±°λ λ€λ₯Έ client μ ν ν°μ΄λ©΄ μ΄μ λ₯Ό ꡬλΆνμ§ μκ³ `{\"active\": false}` λ‘ λ΅ν©λλ€(RFC 7662 Β§4).
|
|
198
|
+
* @summary OAuth 2.0 ν ν° κ²μ¬ (Token Introspection, RFC 7662)
|
|
199
|
+
* @param {IntrospectRequestDto} introspectRequestDto
|
|
200
|
+
* @param {*} [options] Override http request option.
|
|
201
|
+
* @throws {RequiredError}
|
|
202
|
+
*/
|
|
203
|
+
introspect(introspectRequestDto, options) {
|
|
204
|
+
return localVarFp.introspect(introspectRequestDto, options).then((request) => request(axios, basePath));
|
|
205
|
+
},
|
|
149
206
|
/**
|
|
150
207
|
* λ°κΈλ°μ access token μ μ¦μ 무ν¨νν©λλ€. μ μΆμ νμΈνμ λ TTL(15λΆ) λ§λ£λ₯Ό κΈ°λ€λ¦¬μ§ μκ³ λλ κ²½λ‘μ
λλ€. RFC 7009 Β§2.2 μ λ°λΌ μ΄λ―Έ λ§λ£λκ±°λ μ μ μλ ν ν°μ 보λ΄λ 200 μΌλ‘ μλ΅ν©λλ€.
|
|
151
208
|
* @summary OAuth 2.0 ν ν° νκΈ° (Token Revocation, RFC 7009)
|
|
@@ -173,6 +230,16 @@ exports.OauthApiFactory = OauthApiFactory;
|
|
|
173
230
|
* OauthApi - object-oriented interface
|
|
174
231
|
*/
|
|
175
232
|
class OauthApi extends base_1.BaseAPI {
|
|
233
|
+
/**
|
|
234
|
+
* κ°μ§κ³ μλ access token μ΄ μ§κΈλ μ ν¨νμ§, μ΄λ€ μ€μ½νλ₯Ό κ°λμ§ νμΈν©λλ€. μκΈ° ν ν°λ§ μ‘°νν μ μμ΅λλ€ β μμ‘°Β·λ§λ£Β·νκΈ°λκ±°λ λ€λ₯Έ client μ ν ν°μ΄λ©΄ μ΄μ λ₯Ό ꡬλΆνμ§ μκ³ `{\"active\": false}` λ‘ λ΅ν©λλ€(RFC 7662 Β§4).
|
|
235
|
+
* @summary OAuth 2.0 ν ν° κ²μ¬ (Token Introspection, RFC 7662)
|
|
236
|
+
* @param {IntrospectRequestDto} introspectRequestDto
|
|
237
|
+
* @param {*} [options] Override http request option.
|
|
238
|
+
* @throws {RequiredError}
|
|
239
|
+
*/
|
|
240
|
+
introspect(introspectRequestDto, options) {
|
|
241
|
+
return (0, exports.OauthApiFp)(this.configuration).introspect(introspectRequestDto, options).then((request) => request(this.axios, this.basePath));
|
|
242
|
+
}
|
|
176
243
|
/**
|
|
177
244
|
* λ°κΈλ°μ access token μ μ¦μ 무ν¨νν©λλ€. μ μΆμ νμΈνμ λ TTL(15λΆ) λ§λ£λ₯Ό κΈ°λ€λ¦¬μ§ μκ³ λλ κ²½λ‘μ
λλ€. RFC 7009 Β§2.2 μ λ°λΌ μ΄λ―Έ λ§λ£λκ±°λ μ μ μλ ν ν°μ 보λ΄λ 200 μΌλ‘ μλ΅ν©λλ€.
|
|
178
245
|
* @summary OAuth 2.0 ν ν° νκΈ° (Token Revocation, RFC 7009)
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* CMARKET V6 Partner API
|
|
3
|
-
* μΈλΆ ERP μ°λμ© RESTful API. ## λ²μ λ³ μΈμ¦ - **_/v2** β OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν° λ°κΈ ν `Authorization: Bearer <token>` ν€λ. - **_/v1** β V5 μΆ©μ€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν€λλ‘ μ μ‘. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆν κ². - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μλλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `
|
|
3
|
+
* μΈλΆ ERP μ°λμ© RESTful API. ## λ²μ λ³ μΈμ¦ - **_/v2** β OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν° λ°κΈ ν `Authorization: Bearer <token>` ν€λ. - **_/v1** β V5 μΆ©μ€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν€λλ‘ μ μ‘. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆν κ². - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μλλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ μ
μ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , `/v1/_*` μ λκ²°λ λ κ±°μ νλ©΄μ΄λ©°, νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. νΈμΆ νμ μ체λ₯Ό μ€μ΄λ €λ©΄ μΉν
μ μ¬μ©νμΈμ. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**λ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μλλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μΈ κ². slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ λͺ
μλΌ μλ€. μ slug μ μΆκ°λ μ μμΌλ―λ‘, λͺ¨λ₯΄λ slug μ λ§λλ©΄ `type` μ΄ μλλΌ **HTTP status λ‘ ν΄λ°±**νλλ‘ κ΅¬νν κ². ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ΄λ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨λ€. μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ릴 κ². ## λ μ΄νΈ λ¦¬λ° μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ**. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μΈ κ². - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§νλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ νλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλν κ². ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈνλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦°λ€. ## λ²μ μλͺ
(deprecation/sunset) - **_/v1** μ λ κ±°μ V5 cutover μλ£ μμ κΉμ§ μ μ§λλ μΆ©μ€ νλ‘μμ
λλ€. νμ§ μΌμ μ΄ μ ν΄μ§λ©΄ /v1 μλ΅μ ν€λ μΈ κ°κ° μ€λ¦½λλ€ β `Deprecation`(RFC 9745, `@<epochμ΄>`) Β· `Sunset`(RFC 8594, HTTP-date) Β· `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` β μ΄μ μλ΄ λ¬Έμλ₯Ό κ°λ¦¬ν΅λλ€). μΌμ μ΄ μ ν΄μ§κΈ° μ μλ μ
λ€ λκ°μ§ μμ΅λλ€. μ’
λ£μΌμ΄ μ§λ λ€μ νΈμΆμ `404` κ° μλλΌ **`410 Gone`** κ³Ό `type: β¦/endpoint-sunset` μΌλ‘ κ±°μ λ©λλ€. λμ λ»μ΄ λ€λ¦
λλ€ β `404` λ \"κ·Έλ° κ²μ΄ μμλμ§ λͺ¨λ₯΄κ² λ€\", `410` μ \"μμκ³ μλμ μΌλ‘ μμ΄λ€\" μ
λλ€. `410` μ λ°μΌλ©΄ κ²½λ‘ μ€νλ₯Ό μμ¬νμ§ λ§κ³ /v2 λ‘ μ΄μ νμΈμ. - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§νλ€. μλΉμλ μ΄ ν€λλ₯Ό λͺ¨λν°λ§ν κ².
|
|
4
4
|
*
|
|
5
|
-
* The version of the OpenAPI document:
|
|
5
|
+
* The version of the OpenAPI document: 31.1.0
|
|
6
6
|
* Contact: semo.io.kr@gmail.com
|
|
7
7
|
*
|
|
8
8
|
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
/* eslint-disable */
|
|
4
4
|
/**
|
|
5
5
|
* CMARKET V6 Partner API
|
|
6
|
-
* μΈλΆ ERP μ°λμ© RESTful API. ## λ²μ λ³ μΈμ¦ - **_/v2** β OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν° λ°κΈ ν `Authorization: Bearer <token>` ν€λ. - **_/v1** β V5 μΆ©μ€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν€λλ‘ μ μ‘. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆν κ². - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μλλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `
|
|
6
|
+
* μΈλΆ ERP μ°λμ© RESTful API. ## λ²μ λ³ μΈμ¦ - **_/v2** β OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν° λ°κΈ ν `Authorization: Bearer <token>` ν€λ. - **_/v1** β V5 μΆ©μ€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν€λλ‘ μ μ‘. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆν κ². - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μλλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ΄λ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²ν κ². ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ μ
μ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , `/v1/_*` μ λκ²°λ λ κ±°μ νλ©΄μ΄λ©°, νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. νΈμΆ νμ μ체λ₯Ό μ€μ΄λ €λ©΄ μΉν
μ μ¬μ©νμΈμ. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json`. μλΉμλ **HTTP status + `type` URI** λ‘ λΆκΈ°νλ€. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλ, `false`λ©΄ μμ²μ κ³ μ³μΌ νλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**λ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μλλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μΈ κ². slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ λͺ
μλΌ μλ€. μ slug μ μΆκ°λ μ μμΌλ―λ‘, λͺ¨λ₯΄λ slug μ λ§λλ©΄ `type` μ΄ μλλΌ **HTTP status λ‘ ν΄λ°±**νλλ‘ κ΅¬νν κ². ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ΄λ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨λ€. μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ릴 κ². ## λ μ΄νΈ λ¦¬λ° μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ**. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μΈ κ². - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§νλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ νλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλν κ². ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈνλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦°λ€. ## λ²μ μλͺ
(deprecation/sunset) - **_/v1** μ λ κ±°μ V5 cutover μλ£ μμ κΉμ§ μ μ§λλ μΆ©μ€ νλ‘μμ
λλ€. νμ§ μΌμ μ΄ μ ν΄μ§λ©΄ /v1 μλ΅μ ν€λ μΈ κ°κ° μ€λ¦½λλ€ β `Deprecation`(RFC 9745, `@<epochμ΄>`) Β· `Sunset`(RFC 8594, HTTP-date) Β· `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` β μ΄μ μλ΄ λ¬Έμλ₯Ό κ°λ¦¬ν΅λλ€). μΌμ μ΄ μ ν΄μ§κΈ° μ μλ μ
λ€ λκ°μ§ μμ΅λλ€. μ’
λ£μΌμ΄ μ§λ λ€μ νΈμΆμ `404` κ° μλλΌ **`410 Gone`** κ³Ό `type: β¦/endpoint-sunset` μΌλ‘ κ±°μ λ©λλ€. λμ λ»μ΄ λ€λ¦
λλ€ β `404` λ \"κ·Έλ° κ²μ΄ μμλμ§ λͺ¨λ₯΄κ² λ€\", `410` μ \"μμκ³ μλμ μΌλ‘ μμ΄λ€\" μ
λλ€. `410` μ λ°μΌλ©΄ κ²½λ‘ μ€νλ₯Ό μμ¬νμ§ λ§κ³ /v2 λ‘ μ΄μ νμΈμ. - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§νλ€. μλΉμλ μ΄ ν€λλ₯Ό λͺ¨λν°λ§ν κ².
|
|
7
7
|
*
|
|
8
|
-
* The version of the OpenAPI document:
|
|
8
|
+
* The version of the OpenAPI document: 31.1.0
|
|
9
9
|
* Contact: semo.io.kr@gmail.com
|
|
10
10
|
*
|
|
11
11
|
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
@@ -59,7 +59,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
59
59
|
// authentication platform-auth-secret required
|
|
60
60
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
61
61
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
62
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
62
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
63
63
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
64
64
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
65
65
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -98,7 +98,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
98
98
|
// authentication platform-auth-secret required
|
|
99
99
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
100
100
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
101
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
101
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
102
102
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
103
103
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
104
104
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -133,7 +133,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
133
133
|
// authentication platform-auth-secret required
|
|
134
134
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
135
135
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
136
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
136
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
137
137
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
138
138
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
139
139
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -168,7 +168,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
168
168
|
// authentication platform-auth-secret required
|
|
169
169
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
170
170
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
171
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
171
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
172
172
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
173
173
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
174
174
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -203,7 +203,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
203
203
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Id", configuration);
|
|
204
204
|
// authentication platform-auth-secret required
|
|
205
205
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
206
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
206
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
207
207
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
208
208
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
209
209
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -233,7 +233,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
233
233
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Id", configuration);
|
|
234
234
|
// authentication platform-auth-secret required
|
|
235
235
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
236
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
236
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
237
237
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
238
238
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
239
239
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -267,7 +267,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
267
267
|
// authentication platform-auth-secret required
|
|
268
268
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
269
269
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
270
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
270
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
271
271
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
272
272
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
273
273
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -302,7 +302,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
302
302
|
// authentication platform-auth-secret required
|
|
303
303
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
304
304
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
305
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
305
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
306
306
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
307
307
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
308
308
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -337,7 +337,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
337
337
|
// authentication platform-auth-secret required
|
|
338
338
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
339
339
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
340
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
340
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
341
341
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
342
342
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
343
343
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -372,7 +372,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
372
372
|
// authentication platform-auth-secret required
|
|
373
373
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
374
374
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
375
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
375
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
376
376
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
377
377
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
378
378
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -407,7 +407,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
407
407
|
// authentication platform-auth-secret required
|
|
408
408
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
409
409
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
410
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
410
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
411
411
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
412
412
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
413
413
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|
|
@@ -442,7 +442,7 @@ const PartnerV1ApiAxiosParamCreator = function (configuration) {
|
|
|
442
442
|
// authentication platform-auth-secret required
|
|
443
443
|
yield (0, common_1.setApiKeyToObject)(localVarHeaderParameter, "X-Platform-Secret", configuration);
|
|
444
444
|
localVarHeaderParameter['Content-Type'] = 'application/json';
|
|
445
|
-
localVarHeaderParameter['Accept'] = 'application/json';
|
|
445
|
+
localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
|
|
446
446
|
(0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
|
|
447
447
|
let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
|
|
448
448
|
localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
|