[{"data":1,"prerenderedAt":380},["ShallowReactive",2],{"navigation_docs_zh":3,"-zh-operations-versions-and-migrations":340,"-zh-operations-versions-and-migrations-surround":375},[4,22,40,50,64,82,312,326],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":21},"快速开始","i-lucide-rocket","\u002Fzh\u002Fgetting-started","zh\u002F1.getting-started",[10,13,17],{"title":5,"path":11,"stem":12},"\u002Fzh\u002Fgetting-started\u002Fquick-start","zh\u002F1.getting-started\u002F1.quick-start",{"title":14,"path":15,"stem":16},"信任模型","\u002Fzh\u002Fgetting-started\u002Ftrust-model","zh\u002F1.getting-started\u002F2.trust-model",{"title":18,"path":19,"stem":20},"大客户端到端接入指南","\u002Fzh\u002Fgetting-started\u002Fenterprise-integration","zh\u002F1.getting-started\u002F3.enterprise-integration",false,{"title":23,"icon":24,"path":25,"stem":26,"children":27,"page":21},"自研 Storefront","i-lucide-store","\u002Fzh\u002Fstorefront","zh\u002F2.storefront",[28,32,36],{"title":29,"path":30,"stem":31},"第三方 Storefront","\u002Fzh\u002Fstorefront\u002Fthird-party-storefront","zh\u002F2.storefront\u002F1.third-party-storefront",{"title":33,"path":34,"stem":35},"Turnstile 的信任边界","\u002Fzh\u002Fstorefront\u002Fchallenge-and-turnstile","zh\u002F2.storefront\u002F2.challenge-and-turnstile",{"title":37,"path":38,"stem":39},"第三方店铺前端公共 API","\u002Fzh\u002Fstorefront\u002Fpublic-api","zh\u002F2.storefront\u002F3.public-api",{"title":41,"icon":42,"path":43,"stem":44,"children":45,"page":21},"OAuth 与身份","i-lucide-key-round","\u002Fzh\u002Foauth","zh\u002F3.oauth",[46],{"title":47,"path":48,"stem":49},"第三方账号授权安全边界","\u002Fzh\u002Foauth\u002Fauthorization-code-pkce","zh\u002F3.oauth\u002F1.authorization-code-pkce",{"title":51,"icon":52,"path":53,"stem":54,"children":55,"page":21},"开发者平台","i-lucide-blocks","\u002Fzh\u002Fplatform","zh\u002F4.platform",[56,60],{"title":57,"path":58,"stem":59},"应用、版本、安装与 Scope","\u002Fzh\u002Fplatform\u002Fapps-installations-scopes","zh\u002F4.platform\u002F1.apps-installations-scopes",{"title":61,"path":62,"stem":63},"Origin、Redirect、反向代理与环境","\u002Fzh\u002Fplatform\u002Fsecurity-and-environments","zh\u002F4.platform\u002F2.security-and-environments",{"title":65,"icon":66,"path":67,"stem":68,"children":69,"page":21},"运行时扩展","i-lucide-workflow","\u002Fzh\u002Fruntime","zh\u002F5.runtime",[70,74,78],{"title":71,"path":72,"stem":73},"安装级 Webhook","\u002Fzh\u002Fruntime\u002Fwebhooks","zh\u002F5.runtime\u002F1.webhooks",{"title":75,"path":76,"stem":77},"库存同步","\u002Fzh\u002Fruntime\u002Finventory-sync","zh\u002F5.runtime\u002F2.inventory-sync",{"title":79,"path":80,"stem":81},"自动发货 Provider","\u002Fzh\u002Fruntime\u002Fauto-fulfillment","zh\u002F5.runtime\u002F3.auto-fulfillment",{"title":83,"icon":84,"path":85,"stem":86,"children":87,"page":21},"API 参考","i-lucide-braces","\u002Fzh\u002Freference","zh\u002F6.reference",[88,91,95],{"title":83,"path":89,"stem":90},"\u002Fzh\u002Freference\u002Fapi","zh\u002F6.reference\u002F1.api",{"title":92,"path":93,"stem":94},"错误、幂等与限流","\u002Fzh\u002Freference\u002Ferrors-and-limits","zh\u002F6.reference\u002F2.errors-and-limits",{"title":96,"path":97,"stem":98,"children":99,"page":21},"Endpoint 目录","\u002Fzh\u002Freference\u002Foperations","zh\u002F6.reference\u002F3.operations",[100,104,108,112,116,120,124,128,132,136,140,144,148,152,156,160,164,168,172,176,180,184,188,192,196,200,204,208,212,216,220,224,228,232,236,240,244,248,252,256,260,264,268,272,276,280,284,288,292,296,300,304,308],{"title":101,"path":102,"stem":103},"读取公开站点启动配置","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-bootstrap","zh\u002F6.reference\u002F3.operations\u002F01.get-public-bootstrap",{"title":105,"path":106,"stem":107},"读取公开分类","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-categories","zh\u002F6.reference\u002F3.operations\u002F02.list-public-categories",{"title":109,"path":110,"stem":111},"读取店铺公开商品详情","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-merchant-product","zh\u002F6.reference\u002F3.operations\u002F03.get-public-merchant-product",{"title":113,"path":114,"stem":115},"读取店铺公开分类","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-merchant-categories","zh\u002F6.reference\u002F3.operations\u002F04.list-public-merchant-categories",{"title":117,"path":118,"stem":119},"读取店铺公开商品","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-merchant-products","zh\u002F6.reference\u002F3.operations\u002F05.list-public-merchant-products",{"title":121,"path":122,"stem":123},"读取公开店铺资料","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-merchant","zh\u002F6.reference\u002F3.operations\u002F06.get-public-merchant",{"title":125,"path":126,"stem":127},"按 slug 读取公开商品","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-product","zh\u002F6.reference\u002F3.operations\u002F07.get-public-product",{"title":129,"path":130,"stem":131},"读取公开商品目录","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-products","zh\u002F6.reference\u002F3.operations\u002F08.list-public-products",{"title":133,"path":134,"stem":135},"按语言读取当前已发布法律正文","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-legal-documents","zh\u002F6.reference\u002F3.operations\u002F09.list-public-legal-documents",{"title":137,"path":138,"stem":139},"读取官方授权确认事实","\u002Fzh\u002Freference\u002Foperations\u002Fdescribe-oauth-authorization","zh\u002F6.reference\u002F3.operations\u002F10.describe-oauth-authorization",{"title":141,"path":142,"stem":143},"撤销当前 DPoP token family","\u002Fzh\u002Freference\u002Foperations\u002Frevoke-oauth-token","zh\u002F6.reference\u002F3.operations\u002F11.revoke-oauth-token",{"title":145,"path":146,"stem":147},"以 PKCE 或轮换 refresh token 交换 DPoP token","\u002Fzh\u002Freference\u002Foperations\u002Fexchange-oauth-token","zh\u002F6.reference\u002F3.operations\u002F12.exchange-oauth-token",{"title":149,"path":150,"stem":151},"通过 API Key 读取公开分类","\u002Fzh\u002Freference\u002Foperations\u002Flist-api-key-catalog-categories","zh\u002F6.reference\u002F3.operations\u002F13.list-api-key-catalog-categories",{"title":153,"path":154,"stem":155},"通过 API Key 读取公开商品","\u002Fzh\u002Freference\u002Foperations\u002Fget-api-key-catalog-product","zh\u002F6.reference\u002F3.operations\u002F14.get-api-key-catalog-product",{"title":157,"path":158,"stem":159},"通过 API Key 读取公开商品目录","\u002Fzh\u002Freference\u002Foperations\u002Flist-api-key-catalog-products","zh\u002F6.reference\u002F3.operations\u002F15.list-api-key-catalog-products",{"title":161,"path":162,"stem":163},"取消尚未进入不可逆支付阶段的托管结账","\u002Fzh\u002Freference\u002Foperations\u002Fcancel-hosted-checkout-session","zh\u002F6.reference\u002F3.operations\u002F16.cancel-hosted-checkout-session",{"title":165,"path":166,"stem":167},"读取绑定安装的托管结账状态","\u002Fzh\u002Freference\u002Foperations\u002Fget-hosted-checkout-session","zh\u002F6.reference\u002F3.operations\u002F17.get-hosted-checkout-session",{"title":169,"path":170,"stem":171},"创建服务端重算的托管结账会话","\u002Fzh\u002Freference\u002Foperations\u002Fcreate-hosted-checkout-session","zh\u002F6.reference\u002F3.operations\u002F18.create-hosted-checkout-session",{"title":173,"path":174,"stem":175},"创建官方托管登录流程","\u002Fzh\u002Freference\u002Foperations\u002Finitiate-hosted-login","zh\u002F6.reference\u002F3.operations\u002F19.initiate-hosted-login",{"title":177,"path":178,"stem":179},"以 PKCE 单次消费托管登录返回码","\u002Fzh\u002Freference\u002Foperations\u002Fconsume-hosted-login-return","zh\u002F6.reference\u002F3.operations\u002F20.consume-hosted-login-return",{"title":181,"path":182,"stem":183},"读取当前 API Key 的标识与 scope","\u002Fzh\u002Freference\u002Foperations\u002Fget-api-key-identity","zh\u002F6.reference\u002F3.operations\u002F21.get-api-key-identity",{"title":185,"path":186,"stem":187},"读取安装级凭据绑定身份","\u002Fzh\u002Freference\u002Foperations\u002Fget-installation-credential-identity","zh\u002F6.reference\u002F3.operations\u002F22.get-installation-credential-identity",{"title":189,"path":190,"stem":191},"读取安装级凭据就绪与阻塞事实","\u002Fzh\u002Freference\u002Foperations\u002Fget-installation-credential-readiness","zh\u002F6.reference\u002F3.operations\u002F23.get-installation-credential-readiness",{"title":193,"path":194,"stem":195},"校验并保存购物车短期地址令牌","\u002Fzh\u002Freference\u002Foperations\u002Fset-public-cart-address","zh\u002F6.reference\u002F3.operations\u002F24.set-public-cart-address",{"title":197,"path":198,"stem":199},"生成配送税费优惠统一结算报价","\u002Fzh\u002Freference\u002Foperations\u002Fquote-public-cart-checkout","zh\u002F6.reference\u002F3.operations\u002F25.quote-public-cart-checkout",{"title":201,"path":202,"stem":203},"由购物车创建官方托管结账会话","\u002Fzh\u002Freference\u002Foperations\u002Fcheckout-public-cart","zh\u002F6.reference\u002F3.operations\u002F26.checkout-public-cart",{"title":205,"path":206,"stem":207},"清空公开购物车","\u002Fzh\u002Freference\u002Foperations\u002Fclear-public-cart","zh\u002F6.reference\u002F3.operations\u002F27.clear-public-cart",{"title":209,"path":210,"stem":211},"移除公开购物车 SKU","\u002Fzh\u002Freference\u002Foperations\u002Fremove-public-cart-item","zh\u002F6.reference\u002F3.operations\u002F28.remove-public-cart-item",{"title":213,"path":214,"stem":215},"更新公开购物车 SKU 数量","\u002Fzh\u002Freference\u002Foperations\u002Fupdate-public-cart-item-quantity","zh\u002F6.reference\u002F3.operations\u002F29.update-public-cart-item-quantity",{"title":217,"path":218,"stem":219},"向公开购物车添加 SKU","\u002Fzh\u002Freference\u002Foperations\u002Fadd-public-cart-item","zh\u002F6.reference\u002F3.operations\u002F30.add-public-cart-item",{"title":221,"path":222,"stem":223},"移除购物车优惠码","\u002Fzh\u002Freference\u002Foperations\u002Fremove-public-cart-promotion","zh\u002F6.reference\u002F3.operations\u002F31.remove-public-cart-promotion",{"title":225,"path":226,"stem":227},"校验并应用购物车优惠码","\u002Fzh\u002Freference\u002Foperations\u002Fapply-public-cart-promotion","zh\u002F6.reference\u002F3.operations\u002F32.apply-public-cart-promotion",{"title":229,"path":230,"stem":231},"按实时价格与库存生成短期报价","\u002Fzh\u002Freference\u002Foperations\u002Fquote-public-cart","zh\u002F6.reference\u002F3.operations\u002F33.quote-public-cart",{"title":233,"path":234,"stem":235},"撤销公开购物车访问票据","\u002Fzh\u002Freference\u002Foperations\u002Frevoke-public-cart","zh\u002F6.reference\u002F3.operations\u002F34.revoke-public-cart",{"title":237,"path":238,"stem":239},"读取安装绑定的公开购物车","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-cart","zh\u002F6.reference\u002F3.operations\u002F35.get-public-cart",{"title":241,"path":242,"stem":243},"创建安装绑定的公开购物车","\u002Fzh\u002Freference\u002Foperations\u002Fcreate-public-cart","zh\u002F6.reference\u002F3.operations\u002F36.create-public-cart",{"title":245,"path":246,"stem":247},"读取退款退货售后资格","\u002Fzh\u002Freference\u002Foperations\u002Fget-storefront-order-after-sales-eligibility","zh\u002F6.reference\u002F3.operations\u002F37.get-storefront-order-after-sales-eligibility",{"title":249,"path":250,"stem":251},"提交退款或进入官方售后流程","\u002Fzh\u002Freference\u002Foperations\u002Frequest-storefront-order-after-sales","zh\u002F6.reference\u002F3.operations\u002F38.request-storefront-order-after-sales",{"title":253,"path":254,"stem":255},"读取订单取消资格","\u002Fzh\u002Freference\u002Foperations\u002Fget-storefront-order-cancellation-eligibility","zh\u002F6.reference\u002F3.operations\u002F39.get-storefront-order-cancellation-eligibility",{"title":257,"path":258,"stem":259},"cancelStorefrontOrder","\u002Fzh\u002Freference\u002Foperations\u002Fcancel-storefront-order","zh\u002F6.reference\u002F3.operations\u002F40.cancel-storefront-order",{"title":261,"path":262,"stem":263},"读取 receipt 绑定的最小订单状态","\u002Fzh\u002Freference\u002Foperations\u002Fget-storefront-order","zh\u002F6.reference\u002F3.operations\u002F41.get-storefront-order",{"title":265,"path":266,"stem":267},"幂等重放 dead 或 retrying 投递","\u002Fzh\u002Freference\u002Foperations\u002Freplay-installation-webhook-delivery","zh\u002F6.reference\u002F3.operations\u002F42.replay-installation-webhook-delivery",{"title":269,"path":270,"stem":271},"读取安装绑定的最小投递状态","\u002Fzh\u002Freference\u002Foperations\u002Flist-installation-webhook-deliveries","zh\u002F6.reference\u002F3.operations\u002F43.list-installation-webhook-deliveries",{"title":273,"path":274,"stem":275},"读取无 PII 的签名校验 fixture","\u002Fzh\u002Freference\u002Foperations\u002Fget-installation-webhook-signature-fixture","zh\u002F6.reference\u002F3.operations\u002F44.get-installation-webhook-signature-fixture",{"title":277,"path":278,"stem":279},"更新或停用安装绑定的 Webhook 订阅","\u002Fzh\u002Freference\u002Foperations\u002Fupdate-installation-webhook","zh\u002F6.reference\u002F3.operations\u002F45.update-installation-webhook",{"title":281,"path":282,"stem":283},"读取安装绑定的 Webhook 订阅","\u002Fzh\u002Freference\u002Foperations\u002Flist-installation-webhooks","zh\u002F6.reference\u002F3.operations\u002F46.list-installation-webhooks",{"title":285,"path":286,"stem":287},"创建安装绑定的 Webhook 订阅","\u002Fzh\u002Freference\u002Foperations\u002Fcreate-installation-webhook","zh\u002F6.reference\u002F3.operations\u002F47.create-installation-webhook",{"title":289,"path":290,"stem":291},"读取安装获准的 Webhook 事件类型","\u002Fzh\u002Freference\u002Foperations\u002Flist-installation-webhook-events","zh\u002F6.reference\u002F3.operations\u002F48.list-installation-webhook-events",{"title":293,"path":294,"stem":295},"读取公开联系渠道","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-contact","zh\u002F6.reference\u002F3.operations\u002F49.get-public-contact",{"title":297,"path":298,"stem":299},"读取店铺公开安全配置","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-store-security-config","zh\u002F6.reference\u002F3.operations\u002F50.get-public-store-security-config",{"title":301,"path":302,"stem":303},"读取公开运行配置","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-runtime-config","zh\u002F6.reference\u002F3.operations\u002F51.get-public-runtime-config",{"title":305,"path":306,"stem":307},"搜索可公开销售商品","\u002Fzh\u002Freference\u002Foperations\u002Fsearch-public-products","zh\u002F6.reference\u002F3.operations\u002F52.search-public-products",{"title":309,"path":310,"stem":311},"读取店铺已发布装修","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-storefront-decoration","zh\u002F6.reference\u002F3.operations\u002F53.get-public-storefront-decoration",{"title":313,"icon":314,"path":315,"stem":316,"children":317,"page":21},"示例","i-lucide-code-xml","\u002Fzh\u002Fexamples","zh\u002F7.examples",[318,322],{"title":319,"path":320,"stem":321},"最小 Nuxt Storefront","\u002Fzh\u002Fexamples\u002Fnuxt-storefront","zh\u002F7.examples\u002F1.nuxt-storefront",{"title":323,"path":324,"stem":325},"Webhook 验签","\u002Fzh\u002Fexamples\u002Fwebhook-verification","zh\u002F7.examples\u002F2.webhook-verification",{"title":327,"icon":328,"path":329,"stem":330,"children":331,"page":21},"版本与支持","i-lucide-life-buoy","\u002Fzh\u002Foperations","zh\u002F8.operations",[332,336],{"title":333,"path":334,"stem":335},"版本、迁移与变更记录","\u002Fzh\u002Foperations\u002Fversions-and-migrations","zh\u002F8.operations\u002F1.versions-and-migrations",{"title":337,"path":338,"stem":339},"支持与安全披露","\u002Fzh\u002Foperations\u002Fsupport-and-security","zh\u002F8.operations\u002F2.support-and-security",{"id":341,"title":333,"body":342,"description":368,"extension":369,"links":370,"meta":371,"navigation":372,"path":334,"seo":373,"stem":335,"__hash__":374},"docs_zh\u002Fzh\u002F8.operations\u002F1.versions-and-migrations.md",{"type":343,"value":344,"toc":364},"minimark",[345,349,353,361],[346,347,333],"h1",{"id":348},"版本迁移与变更记录",[350,351,352],"p",{},"OpenAPI operation、Webhook payload、受控扩展 Schema 和应用 Manifest 分别版本化。已安装应用持续绑定获批的不可变应用版本，直到商家明确授权升级。新增可选字段可以兼容扩展；删除字段、改变语义、新增必需 scope 或改变签名都必须提供版本化迁移。",[350,354,355,356,360],{},"当前文档版本为 ",[357,358,359],"code",{},"0.1.0","：首次提供公开 Docus 站点、OpenAPI 漂移门禁、第三方 Nuxt Storefront、PKCE 指南、安装级 Webhook、库存防回环与自动发货对账。这是文档与静态示例证据，不代表生产 Provider 已认证。",[350,362,363],{},"升级前应比较已发布 OpenAPI 快照摘要和变更记录，在 sandbox 验证，轮换密钥时保留过渡窗口，并保留幂等状态。Sandbox 凭据和数据永远不能授权 production。",{"title":365,"searchDepth":366,"depth":366,"links":367},"",2,[],"理解 API、Schema、事件、应用版本和文档的兼容边界。","md",null,{},true,{"title":333,"description":368},"60rQpAgQ_kyZtaKn9LAVgGciRsk-EJnbl0DnLoYi4pQ",[376,378],{"title":323,"path":324,"stem":325,"description":377,"children":-1},"对原始 body 验证带时间戳 HMAC，并确保 event ID 只消费一次。",{"title":337,"path":338,"stem":339,"description":379,"children":-1},"在不泄露凭据或个人数据的前提下报告集成问题与疑似漏洞。",1786201435007]