←

开放平台

docs v2.0 · 2026-09

新居住开放平台

面向商家（运营商 / 服务商）与平台运营方的统一入口。开放能力按业务线分开提供：房源（旅居 / 长租 / 民宿）、通用本地生活（保洁 / 维修 / 保姆 / 养老…）、搬家（垂类）。所有开放接口统一使用 HMAC-SHA256 商家签名鉴权，一套凭证按业务线授权，不接受其他鉴权方式。

3 条业务线分开接入 24 个开放接口 · 3 个 Webhook 事件 仅 HMAC-SHA256 一种鉴权 在线签名调试台 回归脚本开箱即用

1 三步接入

1领取凭证平台为商家配置接入密钥，线下下发 vendor_id + hmac_key；密钥等同密码，只放服务端。
2签名调通读签名算法，用在线调试台或回归脚本调通所属业务线的查询接口。
3创建并上架房源走 projects/create（草稿）→ 补价与户型 → projects/status 上架；本地生活 / 搬家商品走 products/create。
环境：联调/演示 https://sytest.meizu.life（本页同源，接口走相对路径 /api/juzhu/*）；生产 Base 以平台接入单下发的域名为准，接口与签名不变。

2 接口文档（按业务线）

🏠 房源（旅居 · 长租 · 民宿）

房源 · v2.0

房源接入 API（商家版）

覆盖商家完整业务流：房源创建 / 更新 / 上下架、户型、逐晚房态，以及订单履约（查单 / 确认 / 拒单），共 14 个接口；含保险标识与最短连住口径，页内可直接签名调真实接口。

HMAC-SHA25614 接口含调试台
打开文档 →

🧹 通用本地生活（保洁 · 维修 · 保姆 · 养老…）

本地生活 · v1.0

本地生活商家接口文档

商家开放接口（HMAC）：商品 create / update / status / delete、城市 / 类目 / 标准品查询、订单状态回调与错误码约定。

HMAC-SHA25610 接口金额单位：分
打开文档（商家接口章节）→

🚚 搬家（moving 垂类）

搬家 · v1.0

搬家服务商接入指引

搬家类目专属业务约定：平台标准品（SPU）引用、商家可售商品（SKU）规则、商家信息与下单信息约定、订单状态机与联调验收清单。接口协议复用本地生活商家接口。

业务约定6 个搬家标准品含联调清单
打开指引 →

🧰 通用工具（各业务线共用）

联调工具

签名与回归脚本

与平台一致的签名算法说明 + 两条端到端回归脚本（房源全生命周期 / 本地生活开放接口），接入方可用来自检签名实现是否正确。

Node 22+可重跑
查看用法 →

3 运营操作手册（按角色）

商家 · 运营

旅居商家运营手册

旅居 / 民宿 / 长租商家专用：入驻开通（账号 · 资质 · 密钥）、房源上架规范（房态 · 连住 · 按晚预订）、订单履约、T+7 结算、旅居彩贝评级与品控抽查、违规治理。

房源 · 旅居B 端视角
打开手册 → 商家 · 运营

本地生活运营服务商操作手册

服务商入驻、商品（SPU/SKU）维护、服务者与排班、订单履约与结算、平台考核，附商家信息与下单信息约定。

家政 / 本地生活B 端视角
打开手册 → 平台 · 运营

平台运营方操作手册（服务认证中台 P 端）

服务认证中台日常运营：商家/服务者准入审核、派单监控、结算对账、证书与评级管理、数据看板。

P 端审核 · 监控 · 结算
打开手册 → 商家 · 工作台

房源工作台（上下架 · 预订）

房源列表、调价、上下架、预订确认；配合房态日历做逐晚库存管理。登录商家 / 平台账号后可写，未登录为只读视图。

B 端登录后可操作
打开工作台 → 商家 · 工作台

房态日历 · 保障配置

逐晚房态（可订 / 关房 / 已订）、批量关房与夜价覆盖、最短连住与保险标识配置，与开放接口同库同口径。

B 端与开放接口同口径
打开工作台 →

4 开放接口速查（均为 HMAC 签名 POST）

4.1 房源业务线（/api/juzhu/housing/vendor/*）

接口说明
POST /housing/vendor/projects/list本商家房源列表（channel / status / city_id / keyword 过滤）
POST /housing/vendor/projects/detail房源详情 + 户型明细
POST /housing/vendor/projects/create创建房源（默认草稿，可带户型）
POST /housing/vendor/projects/update增量更新（价格 / 标签 / 保险 / 最短连住）
POST /housing/vendor/projects/status上架 online / 下架 offline / 草稿 draft
POST /housing/vendor/units/create · units/update户型新增与调价 / 夜价
POST /housing/vendor/stay-calendar/set · stay-calendar/query逐晚房态：关房 / 开房 / 夜价覆盖（已订晚不可改）与商家视角查询
POST /housing/vendor/units/delete删除户型（有关联订单或被占用晚时拒绝）
POST /housing/vendor/bookings/list|detail|confirm|cancel订单履约：查单（手机号掩码）/ 详情 / 确认 / 拒单（自动释放房态，已支付标退款）
Webhook：平台 → 商家booking.created / booking.paid / booking.cancelled 事件推送，同一 HMAC 签名验签；失败重试 3 次，拉单对账兜底

4.2 通用本地生活业务线（/api/juzhu/jiazheng/vendor/*）

接口说明
POST /api/juzhu/jiazheng/vendor/products/list|detail|create|update|status|delete商家商品（服务）管理；金额单位「分」
POST /api/juzhu/jiazheng/vendor/cities|categories|skus/list开放城市 / 类目 / 平台标准品查询
POST /api/juzhu/callback订单状态回调（商家 → 平台，含服务者信息）

4.3 搬家业务线

搬家不自建接口，复用 4.2 的全部开放接口（类目 moving），增量部分是业务约定：引用平台搬家标准品（6 个 SPU）、商家可售商品规则、订单状态机与联调验收清单，见 搬家服务商接入指引。

完整入参出参见对应文档：房源 v2.0 · 本地生活 v1.0（商家接口章节） · 搬家指引。鉴权统一为 HMAC-SHA256，开放接口不接受其他鉴权方式。

5 常见问题

签名失败、上架不生效、房态改不动、密钥遗失……高频问题与排查路径整理在 开放平台 FAQ。

找不到答案？联系平台接入群，报 vendor_id + 接口路径 + timestamp + 返回的 message（不要发密钥）。

开放平台文档中心 · 房源 API v2.0（2026-09）· 本地生活 API v1.0（2026-08-13）· 手册随功能迭代更新。

密钥安全：所有文档与页面不展示真实密钥；调试台签名在浏览器本地完成，密钥仅存本机（可选）。

试点阶段接口字段只增不破坏；发布节奏随政策与试点进展而定，重大变更通过接入单提前通知。