{"openapi":"3.1.0","info":{"title":"DRAIXCOR Marketplace API","version":"1.4.0","description":"Catalog, seller, compliance, commerce, customer-care, logistics, settlement and advertising operations for draixcor.com."},"servers":[{"url":"https://draixcor.com"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/catalog":{"get":{"summary":"Read the active managed storefront catalog","security":[]}},"/api/v1/products":{"get":{"summary":"List catalog products"},"post":{"summary":"Create a product draft","security":[{"bearerAuth":["products:write"]}]}},"/api/v1/products/{id}":{"patch":{"summary":"Update or request activation of a product","security":[{"bearerAuth":["products:write"]}]}},"/api/v1/products/{id}/videos":{"get":{"summary":"List product videos","security":[{"bearerAuth":["products:read"]}]},"post":{"summary":"Upload an MP4, WebM or MOV product video","security":[{"bearerAuth":["products:write"]}]}},"/api/v1/product-videos/{id}":{"get":{"summary":"Stream a video for an active product with HTTP range support","security":[]}},"/api/v1/vendors":{"post":{"summary":"Submit a seller application","security":[]}},"/api/v1/vendors/{id}/registrations":{"post":{"summary":"Submit or verify an EPR, WEEE, battery or VAT registration","security":[{"bearerAuth":["compliance:write"]}]}},"/api/v1/admin/products/actions":{"post":{"summary":"Platform-admin bulk pause, restore, freeze, duplicate or archive products","security":[]}},"/api/v1/admin/sellers/{id}":{"patch":{"summary":"Platform-admin seller approval, restrictions, settlement, staff, risk and notes","security":[]}},"/api/v1/admin/sellers/{id}/registrations/{registrationId}":{"patch":{"summary":"Platform-admin registration review","security":[]}},"/api/v1/compliance/documents":{"post":{"summary":"Upload product or seller compliance evidence","security":[{"bearerAuth":["compliance:write"]}]}},"/api/v1/compliance/documents/{id}":{"patch":{"summary":"Approve or reject compliance evidence","security":[{"bearerAuth":["compliance:review"]}]}},"/api/v1/ads/campaigns":{"get":{"summary":"List campaigns","security":[{"bearerAuth":["ads:read"]}]},"post":{"summary":"Create campaign","security":[{"bearerAuth":["ads:write"]}]}},"/api/v1/ads/creatives":{"post":{"summary":"Create a campaign creative","security":[{"bearerAuth":["ads:write"]}]}},"/api/v1/ads/serve":{"get":{"summary":"Serve an eligible contextual creative","security":[]}},"/api/v1/ads/events":{"post":{"summary":"Record impression or click","security":[]}},"/api/v1/checkout":{"post":{"summary":"Create an order and hosted payment checkout","security":[]}},"/api/v1/orders":{"get":{"summary":"List the signed-in buyer’s orders","security":[]}},"/api/v1/orders/{id}":{"get":{"summary":"Get a buyer-owned or token-authorized order","security":[]}},"/api/v1/payments/mollie/webhook":{"post":{"summary":"Receive and verify payment status updates","security":[]}},"/api/v1/returns":{"post":{"summary":"Open a return, replacement or repair request with a linked support case","security":[]}},"/api/v1/returns/{id}":{"patch":{"summary":"Approve, reject, receive, complete or cancel a return request","security":[]}},"/api/v1/refunds":{"post":{"summary":"Create a full or partial refund","security":[{"bearerAuth":["refunds:write"]}]}},"/api/v1/support/tickets":{"get":{"summary":"List signed-in buyer support tickets","security":[]},"post":{"summary":"Contact DRAIXCOR or the responsible seller","security":[]}},"/api/v1/support/tickets/{id}":{"patch":{"summary":"Escalate, take over, resolve, close or reopen a support case","security":[]}},"/api/v1/support/tickets/{id}/messages":{"get":{"summary":"Read an authorized support conversation","security":[]},"post":{"summary":"Reply with optional protected evidence files","security":[]}},"/api/v1/support/tickets/{id}/attachments/{messageId}/{attachmentIndex}":{"get":{"summary":"Read a protected case attachment","security":[]}},"/api/v1/shipments":{"get":{"summary":"Track a parcel by tracking number","security":[]},"post":{"summary":"Create a shipment","security":[{"bearerAuth":["shipments:write"]}]}},"/api/v1/shipments/{id}/events":{"post":{"summary":"Append a verified carrier event","security":[{"bearerAuth":["shipments:write"]}]}},"/api/v1/shipments/{id}/label":{"get":{"summary":"Read an authorized shipping-label PDF","security":[{"bearerAuth":["shipments:write"]}]},"post":{"summary":"Store or replace a manual shipping-label PDF","security":[{"bearerAuth":["shipments:write"]}]}},"/api/v1/logistics/webhooks/{provider}":{"post":{"summary":"Receive an HMAC-signed normalized carrier event","security":[]}},"/api/v1/admin/logistics/connections":{"post":{"summary":"Register carrier connector metadata without exposing credentials","security":[]}},"/api/v1/admin/settlements":{"post":{"summary":"Reconcile the seller ledger or create eligible settlement drafts","security":[{"bearerAuth":["settlements:write"]}]}},"/api/v1/admin/settlements/{id}":{"patch":{"summary":"Approve, hold, release or record a seller settlement as paid","security":[{"bearerAuth":["settlements:write"]}]}},"/api/v1/reviews":{"get":{"summary":"List published reviews and rating distribution","security":[]},"post":{"summary":"Submit an authenticated customer review","security":[]}},"/api/v1/reviews/{id}":{"patch":{"summary":"Publish or reject a review","security":[{"bearerAuth":["reviews:moderate"]}]}},"/api/v1/reviews/{id}/helpful":{"post":{"summary":"Record a signed-in helpful vote","security":[]}},"/api/v1/wishlist":{"get":{"summary":"List signed-in buyer wishlist","security":[]},"post":{"summary":"Save a product","security":[]},"delete":{"summary":"Remove a saved product","security":[]}},"/api/v1/price-alerts":{"post":{"summary":"Create a consented price-drop alert","security":[]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"DRAIXCOR API key"}}}}