[{"data":1,"prerenderedAt":609},["ShallowReactive",2],{"navigation_docs_zh":3,"-zh-reference-api":228,"-zh-reference-api-surround":604},[4,22,40,50,64,82,200,214],{"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],{"title":101,"path":102,"stem":103},"读取公开运行配置","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-runtime-config","zh\u002F6.reference\u002F3.operations\u002F01.get-public-runtime-config",{"title":105,"path":106,"stem":107},"读取公开站点启动配置","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-bootstrap","zh\u002F6.reference\u002F3.operations\u002F02.get-public-bootstrap",{"title":109,"path":110,"stem":111},"读取公开联系渠道","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-contact","zh\u002F6.reference\u002F3.operations\u002F03.get-public-contact",{"title":113,"path":114,"stem":115},"按语言读取当前已发布法律正文","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-legal-documents","zh\u002F6.reference\u002F3.operations\u002F04.list-public-legal-documents",{"title":117,"path":118,"stem":119},"读取店铺已发布装修","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-storefront-decoration","zh\u002F6.reference\u002F3.operations\u002F05.get-public-storefront-decoration",{"title":121,"path":122,"stem":123},"读取店铺公开安全配置","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-store-security-config","zh\u002F6.reference\u002F3.operations\u002F06.get-public-store-security-config",{"title":125,"path":126,"stem":127},"搜索可公开销售商品","\u002Fzh\u002Freference\u002Foperations\u002Fsearch-public-products","zh\u002F6.reference\u002F3.operations\u002F07.search-public-products",{"title":129,"path":130,"stem":131},"读取公开分类","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-categories","zh\u002F6.reference\u002F3.operations\u002F08.list-public-categories",{"title":133,"path":134,"stem":135},"读取安装级凭据绑定身份","\u002Fzh\u002Freference\u002Foperations\u002Fget-installation-credential-identity","zh\u002F6.reference\u002F3.operations\u002F09.get-installation-credential-identity",{"title":137,"path":138,"stem":139},"读取安装级凭据就绪与阻塞事实","\u002Fzh\u002Freference\u002Foperations\u002Fget-installation-credential-readiness","zh\u002F6.reference\u002F3.operations\u002F10.get-installation-credential-readiness",{"title":141,"path":142,"stem":143},"创建官方托管登录流程","\u002Fzh\u002Freference\u002Foperations\u002Finitiate-hosted-login","zh\u002F6.reference\u002F3.operations\u002F11.initiate-hosted-login",{"title":145,"path":146,"stem":147},"以 PKCE 单次消费托管登录返回码","\u002Fzh\u002Freference\u002Foperations\u002Fconsume-hosted-login-return","zh\u002F6.reference\u002F3.operations\u002F12.consume-hosted-login-return",{"title":149,"path":150,"stem":151},"创建服务端重算的托管结账会话","\u002Fzh\u002Freference\u002Foperations\u002Fcreate-hosted-checkout-session","zh\u002F6.reference\u002F3.operations\u002F13.create-hosted-checkout-session",{"title":153,"path":154,"stem":155},"读取绑定安装的托管结账状态","\u002Fzh\u002Freference\u002Foperations\u002Fget-hosted-checkout-session","zh\u002F6.reference\u002F3.operations\u002F14.get-hosted-checkout-session",{"title":157,"path":158,"stem":159},"取消尚未进入不可逆支付阶段的托管结账","\u002Fzh\u002Freference\u002Foperations\u002Fcancel-hosted-checkout-session","zh\u002F6.reference\u002F3.operations\u002F15.cancel-hosted-checkout-session",{"title":161,"path":162,"stem":163},"读取公开商品目录","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-products","zh\u002F6.reference\u002F3.operations\u002F16.list-public-products",{"title":165,"path":166,"stem":167},"按 slug 读取公开商品","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-product","zh\u002F6.reference\u002F3.operations\u002F17.get-public-product",{"title":169,"path":170,"stem":171},"读取公开店铺资料","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-merchant","zh\u002F6.reference\u002F3.operations\u002F18.get-public-merchant",{"title":173,"path":174,"stem":175},"读取店铺公开商品","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-merchant-products","zh\u002F6.reference\u002F3.operations\u002F19.list-public-merchant-products",{"title":177,"path":178,"stem":179},"读取店铺公开分类","\u002Fzh\u002Freference\u002Foperations\u002Flist-public-merchant-categories","zh\u002F6.reference\u002F3.operations\u002F20.list-public-merchant-categories",{"title":181,"path":182,"stem":183},"读取店铺公开商品详情","\u002Fzh\u002Freference\u002Foperations\u002Fget-public-merchant-product","zh\u002F6.reference\u002F3.operations\u002F21.get-public-merchant-product",{"title":185,"path":186,"stem":187},"读取当前 API Key 的标识与 scope","\u002Fzh\u002Freference\u002Foperations\u002Fget-api-key-identity","zh\u002F6.reference\u002F3.operations\u002F22.get-api-key-identity",{"title":189,"path":190,"stem":191},"通过 API Key 读取公开分类","\u002Fzh\u002Freference\u002Foperations\u002Flist-api-key-catalog-categories","zh\u002F6.reference\u002F3.operations\u002F23.list-api-key-catalog-categories",{"title":193,"path":194,"stem":195},"通过 API Key 读取公开商品目录","\u002Fzh\u002Freference\u002Foperations\u002Flist-api-key-catalog-products","zh\u002F6.reference\u002F3.operations\u002F24.list-api-key-catalog-products",{"title":197,"path":198,"stem":199},"通过 API Key 读取公开商品","\u002Fzh\u002Freference\u002Foperations\u002Fget-api-key-catalog-product","zh\u002F6.reference\u002F3.operations\u002F25.get-api-key-catalog-product",{"title":201,"icon":202,"path":203,"stem":204,"children":205,"page":21},"示例","i-lucide-code-xml","\u002Fzh\u002Fexamples","zh\u002F7.examples",[206,210],{"title":207,"path":208,"stem":209},"最小 Nuxt Storefront","\u002Fzh\u002Fexamples\u002Fnuxt-storefront","zh\u002F7.examples\u002F1.nuxt-storefront",{"title":211,"path":212,"stem":213},"Webhook 验签","\u002Fzh\u002Fexamples\u002Fwebhook-verification","zh\u002F7.examples\u002F2.webhook-verification",{"title":215,"icon":216,"path":217,"stem":218,"children":219,"page":21},"版本与支持","i-lucide-life-buoy","\u002Fzh\u002Foperations","zh\u002F8.operations",[220,224],{"title":221,"path":222,"stem":223},"版本、迁移与变更记录","\u002Fzh\u002Foperations\u002Fversions-and-migrations","zh\u002F8.operations\u002F1.versions-and-migrations",{"title":225,"path":226,"stem":227},"支持与安全披露","\u002Fzh\u002Foperations\u002Fsupport-and-security","zh\u002F8.operations\u002F2.support-and-security",{"id":229,"title":83,"body":230,"description":596,"extension":597,"links":598,"meta":599,"navigation":601,"path":89,"seo":602,"stem":90,"__hash__":603},"docs_zh\u002Fzh\u002F6.reference\u002F1.api.md",{"type":231,"value":232,"toc":584},"minimark",[233,237,260,265,394,398,418,422,469,473,511,514,517,521,524],[234,235,236],"p",{},"当前目录包含 25 个由 API CI 明确发布的 public-only 操作：14 个 Storefront 公开读取、2 个 installation 身份\u002Freadiness 读取、5 个 hosted 后端 session 基础操作和 4 个 API Key 目录读取。未列出的路由均视为私有。",[238,239,240,248,254],"ul",{},[241,242,243,244],"li",{},"API 来源提交: ",[245,246,247],"code",{},"2d63ab5caa6d65c1ea9fe253c5bdfbec77b2a170",[241,249,250,251],{},"OpenAPI SHA-256: ",[245,252,253],{},"33f52714521cbd7573bcc808c38dd8dc189d7bafa2fd3a6d4c914b70853357b2",[241,255,256,257],{},"OpenAPI: ",[245,258,259],{},"3.1.0",[261,262,264],"h2",{"id":263},"storefront-公开读取","Storefront 公开读取",[238,266,267,277,286,295,304,313,322,331,340,349,358,367,376,385],{},[241,268,269],{},[270,271,273,276],"a",{"href":272},".\u002Foperations\u002Fget-public-runtime-config",[245,274,275],{},"GET \u002Fapi\u002Fv1\u002Fruntime-config"," — 读取公开运行配置",[241,278,279],{},[270,280,282,285],{"href":281},".\u002Foperations\u002Fget-public-bootstrap",[245,283,284],{},"GET \u002Fapi\u002Fv1\u002Fbootstrap"," — 读取公开站点启动配置",[241,287,288],{},[270,289,291,294],{"href":290},".\u002Foperations\u002Fget-public-contact",[245,292,293],{},"GET \u002Fapi\u002Fv1\u002Fpublic\u002Fcontact"," — 读取公开联系渠道",[241,296,297],{},[270,298,300,303],{"href":299},".\u002Foperations\u002Flist-public-legal-documents",[245,301,302],{},"GET \u002Fapi\u002Fv1\u002Flegal\u002Fdocuments"," — 按语言读取当前已发布法律正文",[241,305,306],{},[270,307,309,312],{"href":308},".\u002Foperations\u002Fget-public-storefront-decoration",[245,310,311],{},"GET \u002Fapi\u002Fv1\u002Fstorefront-decorations\u002Fmerchants\u002F{slug}"," — 读取店铺已发布装修",[241,314,315],{},[270,316,318,321],{"href":317},".\u002Foperations\u002Fget-public-store-security-config",[245,319,320],{},"GET \u002Fapi\u002Fv1\u002Fpublic\u002Fstore-access\u002F{store}\u002Fconfig"," — 读取店铺公开安全配置",[241,323,324],{},[270,325,327,330],{"href":326},".\u002Foperations\u002Fsearch-public-products",[245,328,329],{},"GET \u002Fapi\u002Fv1\u002Fsearch"," — 搜索可公开销售商品",[241,332,333],{},[270,334,336,339],{"href":335},".\u002Foperations\u002Flist-public-categories",[245,337,338],{},"GET \u002Fapi\u002Fv1\u002Fcatalog\u002Fcategories"," — 读取公开分类",[241,341,342],{},[270,343,345,348],{"href":344},".\u002Foperations\u002Flist-public-products",[245,346,347],{},"GET \u002Fapi\u002Fv1\u002Fcatalog\u002Fproducts"," — 读取公开商品目录",[241,350,351],{},[270,352,354,357],{"href":353},".\u002Foperations\u002Fget-public-product",[245,355,356],{},"GET \u002Fapi\u002Fv1\u002Fcatalog\u002Fproducts\u002F{slug}"," — 按 slug 读取公开商品",[241,359,360],{},[270,361,363,366],{"href":362},".\u002Foperations\u002Fget-public-merchant",[245,364,365],{},"GET \u002Fapi\u002Fv1\u002Fcatalog\u002Fmerchants\u002F{slug}"," — 读取公开店铺资料",[241,368,369],{},[270,370,372,375],{"href":371},".\u002Foperations\u002Flist-public-merchant-products",[245,373,374],{},"GET \u002Fapi\u002Fv1\u002Fcatalog\u002Fmerchants\u002F{slug}\u002Fproducts"," — 读取店铺公开商品",[241,377,378],{},[270,379,381,384],{"href":380},".\u002Foperations\u002Flist-public-merchant-categories",[245,382,383],{},"GET \u002Fapi\u002Fv1\u002Fcatalog\u002Fmerchants\u002F{slug}\u002Fcategories"," — 读取店铺公开分类",[241,386,387],{},[270,388,390,393],{"href":389},".\u002Foperations\u002Fget-public-merchant-product",[245,391,392],{},"GET \u002Fapi\u002Fv1\u002Fcatalog\u002Fmerchants\u002F{merchantSlug}\u002Fproducts\u002F{productSlug}"," — 读取店铺公开商品详情",[261,395,397],{"id":396},"installation-身份与-readiness","Installation 身份与 readiness",[238,399,400,409],{},[241,401,402],{},[270,403,405,408],{"href":404},".\u002Foperations\u002Fget-installation-credential-identity",[245,406,407],{},"GET \u002Fapi\u002Fv1\u002Fopen\u002Finstallation\u002Fidentity"," — 读取安装级凭据绑定身份",[241,410,411],{},[270,412,414,417],{"href":413},".\u002Foperations\u002Fget-installation-credential-readiness",[245,415,416],{},"GET \u002Fapi\u002Fv1\u002Fopen\u002Finstallation\u002Freadiness"," — 读取安装级凭据就绪与阻塞事实",[261,419,421],{"id":420},"hosted-后端-session-基础","Hosted 后端 session 基础",[238,423,424,433,442,451,460],{},[241,425,426],{},[270,427,429,432],{"href":428},".\u002Foperations\u002Finitiate-hosted-login",[245,430,431],{},"POST \u002Fapi\u002Fv1\u002Fopen\u002Fhosted\u002Flogin\u002Finitiate"," — 创建官方托管登录流程",[241,434,435],{},[270,436,438,441],{"href":437},".\u002Foperations\u002Fconsume-hosted-login-return",[245,439,440],{},"POST \u002Fapi\u002Fv1\u002Fopen\u002Fhosted\u002Flogin\u002Freturn"," — 以 PKCE 单次消费托管登录返回码",[241,443,444],{},[270,445,447,450],{"href":446},".\u002Foperations\u002Fcreate-hosted-checkout-session",[245,448,449],{},"POST \u002Fapi\u002Fv1\u002Fopen\u002Fhosted\u002Fcheckout\u002Fsessions"," — 创建服务端重算的托管结账会话",[241,452,453],{},[270,454,456,459],{"href":455},".\u002Foperations\u002Fget-hosted-checkout-session",[245,457,458],{},"GET \u002Fapi\u002Fv1\u002Fopen\u002Fhosted\u002Fcheckout\u002Fsessions\u002F{sessionId}"," — 读取绑定安装的托管结账状态",[241,461,462],{},[270,463,465,468],{"href":464},".\u002Foperations\u002Fcancel-hosted-checkout-session",[245,466,467],{},"POST \u002Fapi\u002Fv1\u002Fopen\u002Fhosted\u002Fcheckout\u002Fsessions\u002F{sessionId}\u002Fcancel"," — 取消尚未进入不可逆支付阶段的托管结账",[261,470,472],{"id":471},"api-key-目录读取","API Key 目录读取",[238,474,475,484,493,502],{},[241,476,477],{},[270,478,480,483],{"href":479},".\u002Foperations\u002Fget-api-key-identity",[245,481,482],{},"GET \u002Fapi\u002Fv1\u002Fopen\u002Fidentity"," — 读取当前 API Key 的标识与 scope",[241,485,486],{},[270,487,489,492],{"href":488},".\u002Foperations\u002Flist-api-key-catalog-categories",[245,490,491],{},"GET \u002Fapi\u002Fv1\u002Fopen\u002Fcatalog\u002Fcategories"," — 通过 API Key 读取公开分类",[241,494,495],{},[270,496,498,501],{"href":497},".\u002Foperations\u002Flist-api-key-catalog-products",[245,499,500],{},"GET \u002Fapi\u002Fv1\u002Fopen\u002Fcatalog\u002Fproducts"," — 通过 API Key 读取公开商品目录",[241,503,504],{},[270,505,507,510],{"href":506},".\u002Foperations\u002Fget-api-key-catalog-product",[245,508,509],{},"GET \u002Fapi\u002Fv1\u002Fopen\u002Fcatalog\u002Fproducts\u002F{slug}"," — 通过 API Key 读取公开商品",[261,512,513],{"id":513},"未开放能力",[234,515,516],{},"OAuth、Turnstile、installation 写入与 Webhook 管理不在本 artifact 中，本站不生成这些 endpoint。Hosted 操作仅提供后端 session 安全基础；官方 UI、订单最终创建、Provider 支付推进、生产配置与迁移尚未完成，不得据此认定支付可用。",[518,519,520],"h3",{"id":520},"权威阻塞原因",[234,522,523],{},"以下状态来自同一 public-only artifact，只解释能力为何尚未开放，不表示 endpoint 已存在。",[525,526,527,540],"table",{},[528,529,530],"thead",{},[531,532,533,537],"tr",{},[534,535,536],"th",{},"能力",[534,538,539],{},"当前阻塞",[541,542,543,552,560,568,576],"tbody",{},[531,544,545,549],{},[546,547,548],"td",{},"OAuth Authorization Code",[546,550,551],{},"仍需 DPoP 与 resource\u002Finstallation 绑定",[531,553,554,557],{},[546,555,556],{},"Installation 写入 API",[546,558,559],{},"仍需 sender-constrained installation credential",[531,561,562,565],{},[546,563,564],{},"订单 API",[546,566,567],{},"仍需租户隔离的公开订单契约",[531,569,570,573],{},[546,571,572],{},"Webhook 订阅 API",[546,574,575],{},"仍需 installation-bound credential",[531,577,578,581],{},[546,579,580],{},"生产启用",[546,582,583],{},"外部 readiness 尚未获得证明",{"title":585,"searchDepth":586,"depth":586,"links":587},"",2,[588,589,590,591,592],{"id":263,"depth":586,"text":264},{"id":396,"depth":586,"text":397},{"id":420,"depth":586,"text":421},{"id":471,"depth":586,"text":472},{"id":513,"depth":586,"text":513,"children":593},[594],{"id":520,"depth":595,"text":520},3,"首批经过审核的公开 API 操作目录。","md",null,{"badge":600},"25 operations",true,{"title":83,"description":596},"Lu7JdH59ZwQ6ZZax1IcZ8DFB79tJgMeX_ES11Cc5808",[605,607],{"title":79,"path":80,"stem":81,"description":606,"children":-1},"使用付款门禁、durable intent、未知结果、对账和 exactly-once 业务效果实现自动发货。",{"title":92,"path":93,"stem":94,"description":608,"children":-1},"按安全错误信封、幂等冲突、配额和挑战语义恢复，不猜测写入结果。",1785961909240]