QUICK START · 快速接入

5 分钟跑通你的第一次对接

这是一份面向首次对接工程师的引导。先建立整体认知，再按推荐路线一步步完成，遇到细节随时点开对应接口文档。

第一步：找到你的场景

不同业务的接入路线略有差异，先对号入座，后面按推荐路线走即可。

下单 → 拍摄制作 → 获取模型数据的标准业务流。

让你的用户免登跳转到众趣编辑并发布模型。

拿到素材数据，或一键推送到安居客、房天下等平台。

无论哪个场景，前两步都一样：拿到凭证、换取 Token。

联系众趣开通账号，获取一对 app_id / app_secret。它们是你所有请求的身份来源，请妥善保管、勿泄露。

✓ 你将得到：一对可用于换取 Token 的凭证。

调用获取 Token 接口换取访问令牌，并在后续请求的请求头中携带它来完成身份校验。Token 有时效，过期后重新获取即可。

✓ 你将得到：一个可用于调用业务接口的有效 Token。

带上 Token 调用你场景下的业务接口；部分异步流程（如制作完成、素材生成、讲房完成）会通过回调把结果通知到你提供的地址。

✓ 你将得到：端到端打通的业务链路。

理解这些术语，能让你少走弯路。

开放平台分配给你的身份凭证，相当于"账号密码"。用于换取 Token，不直接出现在业务请求中。

由凭证换取的临时访问令牌，携带在请求头中证明"你是谁"。有有效期，过期需重新获取。

异步任务完成后，平台主动把结果"推"给你预留的接口地址。你需要提供一个可公网访问的接收地址。

每个接口返回统一结构，其中 code 表示处理结果。对接时建议先熟悉状态码含义以便排错。