{"openapi":"3.1.0","info":{"title":"\u0628\u0627\u062d\u0648\u064a\u0631\u062b \u0644\u0644\u0639\u0637\u0648\u0631  \u2014 Storefront API","version":"1.0.0","description":"Public storefront API for AI agents. Includes MPP (Machine Payment Protocol) payment extensions on payable operations.","contact":{"name":"\u0628\u0627\u062d\u0648\u064a\u0631\u062b \u0644\u0644\u0639\u0637\u0648\u0631 ","url":"https:\/\/bh4pe.com","email":"bh4perfumes@gmail.com"}},"servers":[{"url":"https:\/\/bh4pe.com","description":"Production"}],"x-payment-discovery":{"protocol":"mpp","version":"0.1.0","currency_default":"YER","methods_supported":["card","stripe","cod","tempo","lightning"],"docs":"https:\/\/mpp.dev"},"paths":{"\/products":{"get":{"operationId":"listProducts","summary":"List products in the catalog","tags":["Catalog"],"parameters":[{"name":"category","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"HTML product list","content":{"text\/html":{}}}}}},"\/api\/cart\/add":{"post":{"operationId":"addToCart","summary":"Add a product to the cart","tags":["Cart"],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"integer"},"quantity":{"type":"integer","default":1},"variant_id":{"type":"integer","nullable":true}}}}}},"responses":{"200":{"description":"Cart updated","content":{"application\/json":{}}}}}},"\/checkout":{"get":{"operationId":"startCheckout","summary":"Start a checkout session for the current cart","tags":["Checkout"],"x-payment-info":{"intent":"session","method":"card","currency":"YER","amount":0,"description":"Checkout session for the current cart. Final amount is computed from cart contents at checkout.","methods_supported":["card","stripe","cod","tempo"],"authorization_servers":["https:\/\/bh4pe.com"],"discovery":"https:\/\/bh4pe.com\/.well-known\/oauth-protected-resource"},"responses":{"200":{"description":"Checkout HTML page","content":{"text\/html":{}}}}}},"\/order\/success\/{orderId}":{"get":{"operationId":"getOrderSuccess","summary":"Confirm order payment status","tags":["Checkout"],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"integer"}}],"x-payment-info":{"intent":"charge","method":"card","currency":"YER","amount":0,"description":"Confirms a charge already settled at checkout. Amount is reflected in the order."},"responses":{"200":{"description":"Order success page","content":{"text\/html":{}}}}}},"\/api\/wishlist\/toggle":{"post":{"operationId":"toggleWishlist","summary":"Add or remove a product from the wishlist","tags":["Wishlist"],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"integer"}}}}}},"responses":{"200":{"description":"Wishlist toggled","content":{"application\/json":{}}}}}},"\/push\/vapid-key":{"get":{"operationId":"getVapidKey","summary":"Get VAPID public key for Web Push subscription","tags":["Notifications"],"responses":{"200":{"description":"VAPID key","content":{"application\/json":{}}}}}},"\/push\/subscribe":{"post":{"operationId":"subscribePush","summary":"Subscribe to push notifications","tags":["Notifications"],"responses":{"200":{"description":"Subscribed","content":{"application\/json":{}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CustomerSession":{"type":"apiKey","in":"cookie","name":"laravel_session"}}},"tags":[{"name":"Catalog","description":"Product browsing"},{"name":"Cart","description":"Shopping cart"},{"name":"Checkout","description":"Payment & checkout (MPP-enabled)"},{"name":"Wishlist","description":"Wishlist management"},{"name":"Notifications","description":"Web Push"}],"externalDocs":{"description":"API catalog","url":"https:\/\/bh4pe.com\/.well-known\/api-catalog"}}