GET查看店铺状态与开店进度
/shop需要密钥 · 需要权限 shop:read
返回店铺摘要（不含草稿）、开店各步骤进度、独立域名申请和各类条数。
返回
200店铺总览。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
site | Shop | null | 否 | 店铺摘要，不含草稿；还没有店铺时为 null。 |
site.id | string | 否 | — |
site.slug | string | 否 | — |
site.url | string | 否 | 店铺公开网址。 |
site.mode | string | 否 | shop 是商城店铺。 |
site.name | string | 否 | — |
site.operator_name | string | null | 否 | — |
site.review_status | string | 否 | draft 草稿 / pending 审核中 / approved 已通过 / rejected 被退回。 可选值：draft / pending / approved / rejected |
site.public_status | string | 否 | unpublished 还没公开 / live 公开中 / offline 暂时下线 / suspended 被平台下架。 可选值：unpublished / live / offline / suspended |
site.review_note | string | null | 否 | — |
site.suspend_note | string | null | 否 | — |
site.has_unpublished_changes | boolean | 否 | 草稿和线上公开的版本有没有不同。 |
site.listed | boolean | 否 | 是否已上架合作市场。 |
site.revision | integer | 否 | 店铺的版本号，每次改动加一。 |
site.submitted_at | string（date-time） | null | 否 | — |
site.published_at | string（date-time） | null | 否 | — |
site.created_at | string（date-time） | null | 否 | — |
site.updated_at | string（date-time） | null | 否 | — |
site.draft | object | 否 | 草稿全文：页面、区块、联系方式。GET /shop 里的 site 不含这个字段。 |
site.node_sync | object | 否 | 新加坡副本的同步状态，内部字段，可忽略。 |
steps | array<object> | 否 | 开店各步骤的进度。 |
steps[].key | string | 否 | — |
steps[].state | string | 否 | done / todo / waiting / blocked / unknown。 |
steps[].note | string | 否 | — |
domain | object | null | 否 | 独立域名申请，没有时为 null。 |
counts | object | 否 | — |
counts.products_live | integer | 否 | — |
counts.products_draft | integer | 否 | — |
counts.reports_open | integer | 否 | 未处理举报数。 |
返回示例
{
"site": {
"id": "00000000-0000-0000-0000-000000000001",
"slug": "demo-shop",
"url": "https://demo-shop.example.com/",
"mode": "shop",
"name": "示例商店",
"operator_name": "示例经营者",
"review_status": "approved",
"public_status": "live",
"review_note": null,
"suspend_note": null,
"has_unpublished_changes": false,
"listed": true,
"revision": 7,
"submitted_at": "2026-11-03T02:00:00+00:00",
"published_at": "2026-11-03T02:00:00+00:00",
"created_at": "2026-11-01T02:00:00+00:00",
"updated_at": "2026-11-03T02:00:00+00:00",
"node_sync": {}
},
"steps": [
{
"key": "goods",
"state": "done",
"note": ""
}
],
"domain": null,
"counts": {
"products_live": 3,
"products_draft": 4,
"reports_open": 0
}
}401密钥无效：没带、格式不对、不存在、已过期、已撤销，或店主账号、店铺不可用，一律是同一句，不说明是哪一种。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
detail | string | 是 | 中文说明。 |
403这把密钥没有所需权限，或店铺已被平台下架（下架后只能读，写接口都不行）。
返回字段同 401。
429调用太频繁。响应头 Retry-After 是需要等待的秒数。
返回字段同 401。
503服务暂时不可用，稍后再试。
返回字段同 401。
错误返回的格式和重试建议见 错误处理。
调用示例
curl -X GET 'https://www.zhugejunshi.com/api/user-sites/merchant/open/v1/shop' \
-H 'Authorization: Bearer YOUR_API_KEY'在线调试
这里会用你填的密钥向正式接口发一次真实请求。密钥只留在本页内存里，不保存、不上传到别处，刷新页面后要重新填写。