Appearance
海报生成接口
概述
用于生成路线、景点、商品或邀请海报。
- 接口名称：海报生成
- 调用方：小程序前端
- 请求方式：
POST - 请求路径：
/posters/generate - 请求头要求：可选登录态
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| bizType | string | 是 | 业务类型：route / spot / goods / invite |
| bizId | string | 否 | 业务 ID，invite 场景可为空 |
| shareScene | string | 否 | 分享场景：friend / poster |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| posterUrl | string | 海报地址 |
| shareTitle | string | 分享标题 |
| sharePath | string | 小程序路径 |
成功示例
{"code":"0","message":"ok","data":{"posterUrl":"https://img.example/poster.png","shareTitle":"灵妙儿带你游西湖","sharePath":"/pages/route?id=R001"}}
失败示例
错误码
A0003A0004
接口约束
- 幂等要求：否
- 前后端同步规则：海报生成成功后可直接展示，不需要二次查询
- 缓存/刷新策略：同一业务 10 分钟内可复用最近一次生成结果（AI假设项
A1） - 一致性要求：最终一致
说明
该接口适用于多类分享场景，统一支持路线、景点、商品和邀请海报生成。当前返回结果已包含前端展示和分享所需的核心字段，可直接用于页面展示或分享跳转。