API Reference

This catalog contains 53 public-only operations explicitly released by API CI. Its catalog, authentication, and schemas come only from the same artifact; every route not listed here remains private.

• API source commit: d09b20088ddf112ca33b995a325a37b9a25214d8
• OpenAPI SHA-256: 6da10d0a4841540253c476b1e4a5f5f42c52fa5f20ef975a4c46dc6e7323fb5a
• OpenAPI: 3.1.0

Storefront public reads（14）

• GET /api/v1/bootstrap — Get the public site bootstrap configuration
• GET /api/v1/catalog/categories — List public categories
• GET /api/v1/catalog/merchants/{merchantSlug}/products/{productSlug} — Get a public product for a store
• GET /api/v1/catalog/merchants/{slug}/categories — List public categories for a store
• GET /api/v1/catalog/merchants/{slug}/products — List public products for a store
• GET /api/v1/catalog/merchants/{slug} — Get a public store profile
• GET /api/v1/catalog/products/{slug} — Get a public product by slug
• GET /api/v1/catalog/products — List the public product catalog
• GET /api/v1/legal/documents — List current published legal documents by locale
• GET /api/v1/public/contact — Get public contact channels
• GET /api/v1/public/store-access/{store}/config — Get the public store security configuration
• GET /api/v1/runtime-config — Get the public runtime configuration
• GET /api/v1/search — Search public products
• GET /api/v1/storefront-decorations/merchants/{slug} — Get the published Storefront decoration

Installation identity and readiness（2）

• GET /api/v1/open/installation/identity — Get the installation credential identity
• GET /api/v1/open/installation/readiness — Get the installation credential readiness

Hosted backend foundations（5）

• POST /api/v1/open/hosted/checkout/sessions/{sessionId}/cancel — Cancel a hosted checkout session
• GET /api/v1/open/hosted/checkout/sessions/{sessionId} — Get a hosted checkout session
• POST /api/v1/open/hosted/checkout/sessions — Create a hosted checkout session
• POST /api/v1/open/hosted/login/initiate — Initiate a hosted login session
• POST /api/v1/open/hosted/login/return — Consume a hosted login return

API Key catalog reads（4）

• GET /api/v1/open/catalog/categories — List public categories with an API Key
• GET /api/v1/open/catalog/products/{slug} — Get a public product with an API Key
• GET /api/v1/open/catalog/products — List public products with an API Key
• GET /api/v1/open/identity — Get the current API Key identity and scopes

Storefront carts and quotes（13）

• PUT /api/v1/open/storefront/carts/{cartId}/address — setPublicCartAddress
• GET /api/v1/open/storefront/carts/{cartId}/checkout-quote — quotePublicCartCheckout
• POST /api/v1/open/storefront/carts/{cartId}/checkout — checkoutPublicCart
• POST /api/v1/open/storefront/carts/{cartId}/clear — clearPublicCart
• DELETE /api/v1/open/storefront/carts/{cartId}/items/{skuId} — removePublicCartItem
• PATCH /api/v1/open/storefront/carts/{cartId}/items/{skuId} — updatePublicCartItemQuantity
• POST /api/v1/open/storefront/carts/{cartId}/items — addPublicCartItem
• DELETE /api/v1/open/storefront/carts/{cartId}/promotion — removePublicCartPromotion
• PUT /api/v1/open/storefront/carts/{cartId}/promotion — applyPublicCartPromotion
• POST /api/v1/open/storefront/carts/{cartId}/quote — quotePublicCart
• POST /api/v1/open/storefront/carts/{cartId}/revoke — revokePublicCart
• GET /api/v1/open/storefront/carts/{cartId} — getPublicCart
• POST /api/v1/open/storefront/carts — createPublicCart

Storefront orders and after-sales（5）

• GET /api/v1/open/storefront/orders/{orderId}/after-sales-eligibility — getStorefrontOrderAfterSalesEligibility
• POST /api/v1/open/storefront/orders/{orderId}/after-sales — requestStorefrontOrderAfterSales
• GET /api/v1/open/storefront/orders/{orderId}/cancellation-eligibility — getStorefrontOrderCancellationEligibility
• POST /api/v1/open/storefront/orders/{orderId}/cancellations — cancelStorefrontOrder
• GET /api/v1/open/storefront/orders/{orderId} — getStorefrontOrder

Installation Webhooks（7）

• POST /api/v1/open/webhooks/deliveries/{id}/replay — replayInstallationWebhookDelivery
• GET /api/v1/open/webhooks/deliveries — listInstallationWebhookDeliveries
• GET /api/v1/open/webhooks/endpoints/{id}/signature-fixture — getInstallationWebhookSignatureFixture
• PATCH /api/v1/open/webhooks/endpoints/{id} — updateInstallationWebhook
• GET /api/v1/open/webhooks/endpoints — listInstallationWebhooks
• POST /api/v1/open/webhooks/endpoints — createInstallationWebhook
• GET /api/v1/open/webhooks/events — listInstallationWebhookEvents

OAuth PKCE and DPoP（3）

• GET /api/v1/oauth/authorize — describeOAuthAuthorization
• POST /api/v1/oauth/revoke — revokeOAuthToken
• POST /api/v1/oauth/token — exchangeOAuthToken

Published boundary

The artifact now includes OAuth PKCE/DPoP, installation Webhooks, cart quotes, and order read/cancellation/after-sales operations. Official hosted UI, final order creation, payment execution, and a dedicated refund operation are not declared by this artifact, so this site invents no path or example for them.

Authoritative blockers

These statuses come from the same public-only artifact. They explain why a capability is not available; they do not imply that an endpoint exists.