marco
a2263b48a0
- 单文件 docs/API.md 拆成 docs/api/: README.md(传送门索引: 11 接口总览表 + 通用约定 + 复用结构) + 11 个一接口一文件, 便于接口增多后维护 - 补全此前 API.md 与技术文档均遗漏的核心接口 coupon-step.md (一键领券透传 pricebot-backend, 唯一需 JWT 鉴权的业务接口) - 更新 后端技术实现.md: 业务补"领券透传"块、目录补 coupon.py、新增 coupon/step 节、 配置补 PRICEBOT_*、接口索引改指向 docs/api/ Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.2 KiB
1.2 KiB
POST /api/v1/meituan/coupons — 券列表 / 搜索
所属:美团 CPS 组（前缀
/api/v1/meituan,全部无鉴权） | 鉴权:无 | ← 返回 API 索引
入参
| 字段 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
longitude |
float | ✅ | — | 经度 |
latitude |
float | ✅ | — | 纬度 |
platform |
int | ❌ | 1 | 1=外卖/到家, 2=到店 |
biz_line |
int | ❌ | null | 到店子类:1到餐 2到综 3酒店 4门票 |
list_topic_id |
int | ❌ | 3 | 榜单:1精选 2今日必推 3爆款筛选 5限时筛选 |
keyword |
string | ❌ | null | 搜索词（填了则忽略 list_topic_id,走搜索） |
sort_field |
int | ❌ | null | 1价格 2销量 6离我最近（搜索时默认 6） |
search_id |
string | ❌ | null | 翻页 token,首页不填 |
page |
int | ❌ | 1 | ≥1 |
page_size |
int | ❌ | 20 | 1–20 |
出参
响应 200:{ items: CouponCard[], has_next: bool, search_id: string|null }。CouponCard 结构见 API 索引。
错误码
502美团接口失败
说明
当前 Android 客户端未调用此接口(搜索功能尚未实现),仅后端实现完整。