[{"data":1,"prerenderedAt":533},["ShallowReactive",2],{"navigation_docs_en":3,"-en-reference-errors-and-limits":366,"-en-reference-errors-and-limits-surround":528},[4,23,41,51,65,83,338,352],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":22},"Getting started","i-lucide-rocket","\u002Fen\u002Fgetting-started","en\u002F1.getting-started",[10,14,18],{"title":11,"path":12,"stem":13},"Quick start","\u002Fen\u002Fgetting-started\u002Fquick-start","en\u002F1.getting-started\u002F1.quick-start",{"title":15,"path":16,"stem":17},"Trust model","\u002Fen\u002Fgetting-started\u002Ftrust-model","en\u002F1.getting-started\u002F2.trust-model",{"title":19,"path":20,"stem":21},"Enterprise integration journey","\u002Fen\u002Fgetting-started\u002Fenterprise-integration","en\u002F1.getting-started\u002F3.enterprise-integration",false,{"title":24,"icon":25,"path":26,"stem":27,"children":28,"page":22},"Storefront","i-lucide-store","\u002Fen\u002Fstorefront","en\u002F2.storefront",[29,33,37],{"title":30,"path":31,"stem":32},"Third-party Storefront","\u002Fen\u002Fstorefront\u002Fthird-party-storefront","en\u002F2.storefront\u002F1.third-party-storefront",{"title":34,"path":35,"stem":36},"Turnstile trust boundary","\u002Fen\u002Fstorefront\u002Fchallenge-and-turnstile","en\u002F2.storefront\u002F2.challenge-and-turnstile",{"title":38,"path":39,"stem":40},"Third-party Storefront public API","\u002Fen\u002Fstorefront\u002Fpublic-api","en\u002F2.storefront\u002F3.public-api",{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":22},"OAuth and identity","i-lucide-key-round","\u002Fen\u002Foauth","en\u002F3.oauth",[47],{"title":48,"path":49,"stem":50},"Third-party account authorization boundary","\u002Fen\u002Foauth\u002Fauthorization-code-pkce","en\u002F3.oauth\u002F1.authorization-code-pkce",{"title":52,"icon":53,"path":54,"stem":55,"children":56,"page":22},"Developer platform","i-lucide-blocks","\u002Fen\u002Fplatform","en\u002F4.platform",[57,61],{"title":58,"path":59,"stem":60},"Apps, versions, installations, and scopes","\u002Fen\u002Fplatform\u002Fapps-installations-scopes","en\u002F4.platform\u002F1.apps-installations-scopes",{"title":62,"path":63,"stem":64},"Origins, redirects, proxies, and environments","\u002Fen\u002Fplatform\u002Fsecurity-and-environments","en\u002F4.platform\u002F2.security-and-environments",{"title":66,"icon":67,"path":68,"stem":69,"children":70,"page":22},"Runtime extensions","i-lucide-workflow","\u002Fen\u002Fruntime","en\u002F5.runtime",[71,75,79],{"title":72,"path":73,"stem":74},"Installation Webhooks","\u002Fen\u002Fruntime\u002Fwebhooks","en\u002F5.runtime\u002F1.webhooks",{"title":76,"path":77,"stem":78},"Inventory synchronization","\u002Fen\u002Fruntime\u002Finventory-sync","en\u002F5.runtime\u002F2.inventory-sync",{"title":80,"path":81,"stem":82},"Automatic fulfillment providers","\u002Fen\u002Fruntime\u002Fauto-fulfillment","en\u002F5.runtime\u002F3.auto-fulfillment",{"title":84,"icon":85,"path":86,"stem":87,"children":88,"page":22},"API reference","i-lucide-braces","\u002Fen\u002Freference","en\u002F6.reference",[89,93,97],{"title":90,"path":91,"stem":92},"API Reference","\u002Fen\u002Freference\u002Fapi","en\u002F6.reference\u002F1.api",{"title":94,"path":95,"stem":96},"Errors, idempotency, and rate limits","\u002Fen\u002Freference\u002Ferrors-and-limits","en\u002F6.reference\u002F2.errors-and-limits",{"title":98,"path":99,"stem":100,"children":101,"page":22},"Endpoint catalog","\u002Fen\u002Freference\u002Foperations","en\u002F6.reference\u002F3.operations",[102,106,110,114,118,122,126,130,134,138,142,146,150,154,158,162,166,170,174,178,182,186,190,194,198,202,206,210,214,218,222,226,230,234,238,242,246,250,254,258,262,266,270,274,278,282,286,290,294,298,302,306,310,314,318,322,326,330,334],{"title":103,"path":104,"stem":105},"confirmOfficialPasswordReset","\u002Fen\u002Freference\u002Foperations\u002Fconfirm-official-password-reset","en\u002F6.reference\u002F3.operations\u002F01.confirm-official-password-reset",{"title":107,"path":108,"stem":109},"requestOfficialPasswordReset","\u002Fen\u002Freference\u002Foperations\u002Frequest-official-password-reset","en\u002F6.reference\u002F3.operations\u002F02.request-official-password-reset",{"title":111,"path":112,"stem":113},"registerOfficialStorefrontCustomer","\u002Fen\u002Freference\u002Foperations\u002Fregister-official-storefront-customer","en\u002F6.reference\u002F3.operations\u002F03.register-official-storefront-customer",{"title":115,"path":116,"stem":117},"Get the public site bootstrap configuration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-bootstrap","en\u002F6.reference\u002F3.operations\u002F04.get-public-bootstrap",{"title":119,"path":120,"stem":121},"List public categories","\u002Fen\u002Freference\u002Foperations\u002Flist-public-categories","en\u002F6.reference\u002F3.operations\u002F05.list-public-categories",{"title":123,"path":124,"stem":125},"Get a public product for a store","\u002Fen\u002Freference\u002Foperations\u002Fget-public-merchant-product","en\u002F6.reference\u002F3.operations\u002F06.get-public-merchant-product",{"title":127,"path":128,"stem":129},"List public categories for a store","\u002Fen\u002Freference\u002Foperations\u002Flist-public-merchant-categories","en\u002F6.reference\u002F3.operations\u002F07.list-public-merchant-categories",{"title":131,"path":132,"stem":133},"List public products for a store","\u002Fen\u002Freference\u002Foperations\u002Flist-public-merchant-products","en\u002F6.reference\u002F3.operations\u002F08.list-public-merchant-products",{"title":135,"path":136,"stem":137},"Get a public store profile","\u002Fen\u002Freference\u002Foperations\u002Fget-public-merchant","en\u002F6.reference\u002F3.operations\u002F09.get-public-merchant",{"title":139,"path":140,"stem":141},"Get a public product by slug","\u002Fen\u002Freference\u002Foperations\u002Fget-public-product","en\u002F6.reference\u002F3.operations\u002F10.get-public-product",{"title":143,"path":144,"stem":145},"List the public product catalog","\u002Fen\u002Freference\u002Foperations\u002Flist-public-products","en\u002F6.reference\u002F3.operations\u002F11.list-public-products",{"title":147,"path":148,"stem":149},"List current published legal documents by locale","\u002Fen\u002Freference\u002Foperations\u002Flist-public-legal-documents","en\u002F6.reference\u002F3.operations\u002F12.list-public-legal-documents",{"title":151,"path":152,"stem":153},"describeOAuthAuthorization","\u002Fen\u002Freference\u002Foperations\u002Fdescribe-oauth-authorization","en\u002F6.reference\u002F3.operations\u002F13.describe-oauth-authorization",{"title":155,"path":156,"stem":157},"revokeOAuthToken","\u002Fen\u002Freference\u002Foperations\u002Frevoke-oauth-token","en\u002F6.reference\u002F3.operations\u002F14.revoke-oauth-token",{"title":159,"path":160,"stem":161},"exchangeOAuthToken","\u002Fen\u002Freference\u002Foperations\u002Fexchange-oauth-token","en\u002F6.reference\u002F3.operations\u002F15.exchange-oauth-token",{"title":163,"path":164,"stem":165},"List public categories with an API Key","\u002Fen\u002Freference\u002Foperations\u002Flist-api-key-catalog-categories","en\u002F6.reference\u002F3.operations\u002F16.list-api-key-catalog-categories",{"title":167,"path":168,"stem":169},"Get a public product with an API Key","\u002Fen\u002Freference\u002Foperations\u002Fget-api-key-catalog-product","en\u002F6.reference\u002F3.operations\u002F17.get-api-key-catalog-product",{"title":171,"path":172,"stem":173},"List public products with an API Key","\u002Fen\u002Freference\u002Foperations\u002Flist-api-key-catalog-products","en\u002F6.reference\u002F3.operations\u002F18.list-api-key-catalog-products",{"title":175,"path":176,"stem":177},"Cancel a hosted checkout session","\u002Fen\u002Freference\u002Foperations\u002Fcancel-hosted-checkout-session","en\u002F6.reference\u002F3.operations\u002F19.cancel-hosted-checkout-session",{"title":179,"path":180,"stem":181},"Get a hosted checkout session","\u002Fen\u002Freference\u002Foperations\u002Fget-hosted-checkout-session","en\u002F6.reference\u002F3.operations\u002F20.get-hosted-checkout-session",{"title":183,"path":184,"stem":185},"Create a hosted checkout session","\u002Fen\u002Freference\u002Foperations\u002Fcreate-hosted-checkout-session","en\u002F6.reference\u002F3.operations\u002F21.create-hosted-checkout-session",{"title":187,"path":188,"stem":189},"Initiate a hosted login session","\u002Fen\u002Freference\u002Foperations\u002Finitiate-hosted-login","en\u002F6.reference\u002F3.operations\u002F22.initiate-hosted-login",{"title":191,"path":192,"stem":193},"Consume a hosted login return","\u002Fen\u002Freference\u002Foperations\u002Fconsume-hosted-login-return","en\u002F6.reference\u002F3.operations\u002F23.consume-hosted-login-return",{"title":195,"path":196,"stem":197},"Get the current API Key identity and scopes","\u002Fen\u002Freference\u002Foperations\u002Fget-api-key-identity","en\u002F6.reference\u002F3.operations\u002F24.get-api-key-identity",{"title":199,"path":200,"stem":201},"Get the installation credential identity","\u002Fen\u002Freference\u002Foperations\u002Fget-installation-credential-identity","en\u002F6.reference\u002F3.operations\u002F25.get-installation-credential-identity",{"title":203,"path":204,"stem":205},"Get the installation credential readiness","\u002Fen\u002Freference\u002Foperations\u002Fget-installation-credential-readiness","en\u002F6.reference\u002F3.operations\u002F26.get-installation-credential-readiness",{"title":207,"path":208,"stem":209},"setPublicCartAddress","\u002Fen\u002Freference\u002Foperations\u002Fset-public-cart-address","en\u002F6.reference\u002F3.operations\u002F27.set-public-cart-address",{"title":211,"path":212,"stem":213},"quotePublicCartCheckout","\u002Fen\u002Freference\u002Foperations\u002Fquote-public-cart-checkout","en\u002F6.reference\u002F3.operations\u002F28.quote-public-cart-checkout",{"title":215,"path":216,"stem":217},"checkoutPublicCart","\u002Fen\u002Freference\u002Foperations\u002Fcheckout-public-cart","en\u002F6.reference\u002F3.operations\u002F29.checkout-public-cart",{"title":219,"path":220,"stem":221},"clearPublicCart","\u002Fen\u002Freference\u002Foperations\u002Fclear-public-cart","en\u002F6.reference\u002F3.operations\u002F30.clear-public-cart",{"title":223,"path":224,"stem":225},"removePublicCartItem","\u002Fen\u002Freference\u002Foperations\u002Fremove-public-cart-item","en\u002F6.reference\u002F3.operations\u002F31.remove-public-cart-item",{"title":227,"path":228,"stem":229},"updatePublicCartItemQuantity","\u002Fen\u002Freference\u002Foperations\u002Fupdate-public-cart-item-quantity","en\u002F6.reference\u002F3.operations\u002F32.update-public-cart-item-quantity",{"title":231,"path":232,"stem":233},"addPublicCartItem","\u002Fen\u002Freference\u002Foperations\u002Fadd-public-cart-item","en\u002F6.reference\u002F3.operations\u002F33.add-public-cart-item",{"title":235,"path":236,"stem":237},"removePublicCartPromotion","\u002Fen\u002Freference\u002Foperations\u002Fremove-public-cart-promotion","en\u002F6.reference\u002F3.operations\u002F34.remove-public-cart-promotion",{"title":239,"path":240,"stem":241},"applyPublicCartPromotion","\u002Fen\u002Freference\u002Foperations\u002Fapply-public-cart-promotion","en\u002F6.reference\u002F3.operations\u002F35.apply-public-cart-promotion",{"title":243,"path":244,"stem":245},"quotePublicCart","\u002Fen\u002Freference\u002Foperations\u002Fquote-public-cart","en\u002F6.reference\u002F3.operations\u002F36.quote-public-cart",{"title":247,"path":248,"stem":249},"revokePublicCart","\u002Fen\u002Freference\u002Foperations\u002Frevoke-public-cart","en\u002F6.reference\u002F3.operations\u002F37.revoke-public-cart",{"title":251,"path":252,"stem":253},"getPublicCart","\u002Fen\u002Freference\u002Foperations\u002Fget-public-cart","en\u002F6.reference\u002F3.operations\u002F38.get-public-cart",{"title":255,"path":256,"stem":257},"createPublicCart","\u002Fen\u002Freference\u002Foperations\u002Fcreate-public-cart","en\u002F6.reference\u002F3.operations\u002F39.create-public-cart",{"title":259,"path":260,"stem":261},"getStorefrontOrderAfterSalesEligibility","\u002Fen\u002Freference\u002Foperations\u002Fget-storefront-order-after-sales-eligibility","en\u002F6.reference\u002F3.operations\u002F40.get-storefront-order-after-sales-eligibility",{"title":263,"path":264,"stem":265},"requestStorefrontOrderAfterSales","\u002Fen\u002Freference\u002Foperations\u002Frequest-storefront-order-after-sales","en\u002F6.reference\u002F3.operations\u002F41.request-storefront-order-after-sales",{"title":267,"path":268,"stem":269},"getStorefrontOrderCancellationEligibility","\u002Fen\u002Freference\u002Foperations\u002Fget-storefront-order-cancellation-eligibility","en\u002F6.reference\u002F3.operations\u002F42.get-storefront-order-cancellation-eligibility",{"title":271,"path":272,"stem":273},"cancelStorefrontOrder","\u002Fen\u002Freference\u002Foperations\u002Fcancel-storefront-order","en\u002F6.reference\u002F3.operations\u002F43.cancel-storefront-order",{"title":275,"path":276,"stem":277},"getStorefrontOrder","\u002Fen\u002Freference\u002Foperations\u002Fget-storefront-order","en\u002F6.reference\u002F3.operations\u002F44.get-storefront-order",{"title":279,"path":280,"stem":281},"listStorefrontOrders","\u002Fen\u002Freference\u002Foperations\u002Flist-storefront-orders","en\u002F6.reference\u002F3.operations\u002F45.list-storefront-orders",{"title":283,"path":284,"stem":285},"replayInstallationWebhookDelivery","\u002Fen\u002Freference\u002Foperations\u002Freplay-installation-webhook-delivery","en\u002F6.reference\u002F3.operations\u002F46.replay-installation-webhook-delivery",{"title":287,"path":288,"stem":289},"listInstallationWebhookDeliveries","\u002Fen\u002Freference\u002Foperations\u002Flist-installation-webhook-deliveries","en\u002F6.reference\u002F3.operations\u002F47.list-installation-webhook-deliveries",{"title":291,"path":292,"stem":293},"getInstallationWebhookSignatureFixture","\u002Fen\u002Freference\u002Foperations\u002Fget-installation-webhook-signature-fixture","en\u002F6.reference\u002F3.operations\u002F48.get-installation-webhook-signature-fixture",{"title":295,"path":296,"stem":297},"updateInstallationWebhook","\u002Fen\u002Freference\u002Foperations\u002Fupdate-installation-webhook","en\u002F6.reference\u002F3.operations\u002F49.update-installation-webhook",{"title":299,"path":300,"stem":301},"listInstallationWebhooks","\u002Fen\u002Freference\u002Foperations\u002Flist-installation-webhooks","en\u002F6.reference\u002F3.operations\u002F50.list-installation-webhooks",{"title":303,"path":304,"stem":305},"createInstallationWebhook","\u002Fen\u002Freference\u002Foperations\u002Fcreate-installation-webhook","en\u002F6.reference\u002F3.operations\u002F51.create-installation-webhook",{"title":307,"path":308,"stem":309},"listInstallationWebhookEvents","\u002Fen\u002Freference\u002Foperations\u002Flist-installation-webhook-events","en\u002F6.reference\u002F3.operations\u002F52.list-installation-webhook-events",{"title":311,"path":312,"stem":313},"Get public contact channels","\u002Fen\u002Freference\u002Foperations\u002Fget-public-contact","en\u002F6.reference\u002F3.operations\u002F53.get-public-contact",{"title":315,"path":316,"stem":317},"verifyStorefrontChallenge","\u002Fen\u002Freference\u002Foperations\u002Fverify-storefront-challenge","en\u002F6.reference\u002F3.operations\u002F54.verify-storefront-challenge",{"title":319,"path":320,"stem":321},"createStorefrontChallenge","\u002Fen\u002Freference\u002Foperations\u002Fcreate-storefront-challenge","en\u002F6.reference\u002F3.operations\u002F55.create-storefront-challenge",{"title":323,"path":324,"stem":325},"Get the public store security configuration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-store-security-config","en\u002F6.reference\u002F3.operations\u002F56.get-public-store-security-config",{"title":327,"path":328,"stem":329},"Get the public runtime configuration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-runtime-config","en\u002F6.reference\u002F3.operations\u002F57.get-public-runtime-config",{"title":331,"path":332,"stem":333},"Search public products","\u002Fen\u002Freference\u002Foperations\u002Fsearch-public-products","en\u002F6.reference\u002F3.operations\u002F58.search-public-products",{"title":335,"path":336,"stem":337},"Get the published Storefront decoration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-storefront-decoration","en\u002F6.reference\u002F3.operations\u002F59.get-public-storefront-decoration",{"title":339,"icon":340,"path":341,"stem":342,"children":343,"page":22},"Examples","i-lucide-code-xml","\u002Fen\u002Fexamples","en\u002F7.examples",[344,348],{"title":345,"path":346,"stem":347},"Minimal Nuxt Storefront","\u002Fen\u002Fexamples\u002Fnuxt-storefront","en\u002F7.examples\u002F1.nuxt-storefront",{"title":349,"path":350,"stem":351},"Webhook verification","\u002Fen\u002Fexamples\u002Fwebhook-verification","en\u002F7.examples\u002F2.webhook-verification",{"title":353,"icon":354,"path":355,"stem":356,"children":357,"page":22},"Versions and support","i-lucide-life-buoy","\u002Fen\u002Foperations","en\u002F8.operations",[358,362],{"title":359,"path":360,"stem":361},"Versions, migrations, and changelog","\u002Fen\u002Foperations\u002Fversions-and-migrations","en\u002F8.operations\u002F1.versions-and-migrations",{"title":363,"path":364,"stem":365},"Support and security disclosure","\u002Fen\u002Foperations\u002Fsupport-and-security","en\u002F8.operations\u002F2.support-and-security",{"id":367,"title":94,"body":368,"description":521,"extension":522,"links":523,"meta":524,"navigation":525,"path":95,"seo":526,"stem":96,"__hash__":527},"docs_en\u002Fen\u002F6.reference\u002F2.errors-and-limits.md",{"type":369,"value":370,"toc":517},"minimark",[371,375,384,510],[372,373,94],"h1",{"id":374},"errors-idempotency-and-rate-limits",[376,377,378,379,383],"p",{},"Errors use a stable machine code, a safe message, and a request correlation ID. Never parse human text as protocol. A write that times out is ",[380,381,382],"strong",{},"unknown",", not failed: query by its idempotency key before retrying.",[385,386,387,403],"table",{},[388,389,390],"thead",{},[391,392,393,397,400],"tr",{},[394,395,396],"th",{},"HTTP",[394,398,399],{},"Meaning",[394,401,402],{},"Client action",[404,405,406,425,438,451,464,480,497],"tbody",{},[391,407,408,419,422],{},[409,410,411,415,416],"td",{},[412,413,414],"code",{},"400"," \u002F ",[412,417,418],{},"422",[409,420,421],{},"Invalid request or domain validation",[409,423,424],{},"Correct the submitted fields; do not retry unchanged.",[391,426,427,432,435],{},[409,428,429],{},[412,430,431],{},"401",[409,433,434],{},"Missing, expired, or revoked authentication",[409,436,437],{},"Reauthorize safely; never widen CORS.",[391,439,440,445,448],{},[409,441,442],{},[412,443,444],{},"403",[409,446,447],{},"Scope, role, store, market, consent, or capability denied",[409,449,450],{},"Stop and request an authorized grant.",[391,452,453,458,461],{},[409,454,455],{},[412,456,457],{},"404",[409,459,460],{},"Hidden or absent resource",[409,462,463],{},"Do not enumerate identifiers.",[391,465,466,474,477],{},[409,467,468,415,471],{},[412,469,470],{},"409",[412,472,473],{},"412",[409,475,476],{},"Idempotency or optimistic-version conflict",[409,478,479],{},"Reload the authoritative resource and reconcile.",[391,481,482,487,490],{},[409,483,484],{},[412,485,486],{},"429",[409,488,489],{},"Rate limit or risk challenge",[409,491,492,493,496],{},"Honor ",[412,494,495],{},"Retry-After","; complete a challenge only when instructed.",[391,498,499,504,507],{},[409,500,501],{},[412,502,503],{},"5xx",[409,505,506],{},"Service unavailable or unknown outcome",[409,508,509],{},"Preserve intent, back off, then reconcile.",[376,511,512,513,516],{},"Limits are evaluated by app, installation, tenant\u002Fstore, route, and risk tier—not only IP. Turnstile is currently planned\u002Fnot enabled. Even after future Siteverify validation, it proves only one bot-challenge result. ",[412,514,515],{},"cf_clearance"," is not login state and cannot bypass OAuth scopes, tenant ownership, quotas, or sensitive-operation step-up.",{"title":518,"searchDepth":519,"depth":519,"links":520},"",2,[],"Handle safe error envelopes, retries, idempotency conflicts, quotas, and challenges without guessing outcomes.","md",null,{},true,{"title":94,"description":521},"zbgaoYkxdso4igcXSGsdv1O_BE6Dy2z7dYcyPq51YlU",[529,531],{"title":90,"path":91,"stem":92,"description":530,"children":-1},"The first reviewed public API operation catalog.",{"title":103,"path":104,"stem":105,"description":532,"children":-1},"POST \u002Fapi\u002Fv1\u002Fauth\u002Fpassword\u002Freset\u002Fconfirm",1786207768485]