INTEGRATION FLOW
对接流程
流程涵盖从 API 密钥发放到公开渠道运营。起始阶段两种方式相同;在实现与运营阶段,可在登录联动(handoff)或合同联动(自营销售)之间选择其一。
PHASE 01
开始(通用)
两种方式通用的准备步骤。
申请使用 API
提交申请后,管理员审核通过会创建私有通道,并可生成 API Key。
测试房源与渠道映射
在房东页面创建测试房源并设置渠道映射信息。
通过 MCP 浏览文档
在 AI 编码助手中配置 MCP 后,可直接查看 plott LIFE Open API 文档并进行开发。
PHASE 02
选择接入方式
根据合作方要承担的范围选择方式,系统会显示相应的实现与运营步骤。
仅联动房源列表与登录,合同与支付转至 plott LIFE 页面处理。
IMPLEMENT
实现
房源列表联动
通过 Open API 查询房源与价格并在合作方展示。
用户创建联动
通过 POST /open/v1/user 将合作方用户幂等创建为 plott LIFE 用户。
发放登录票据
通过 POST /open/v1/userLoginTicket 发放一次性登录票据(5分钟·一次性)。
OPERATE
运营
房源展示 + 票据发放
在合作方展示房源,用户选房后发放登录票据。
跳转至 plott LIFE
重定向至 /rooms/{id}?ticket= 时,plott LIFE 会自动登录。
合同与支付由 plott LIFE 处理
之后合同与支付在 plott LIFE 页面进行。
DOCUMENTATION
准备好开始正式对接了吗?
端点、认证、错误码等 — 在此查看全部内容。