imaotai-api

本技能适用于开发 imaotai_autobuy 项目的 api/ 模块，旨在为 i茅台 APP 的 HTTPS REST API 集成提供全面规范。内容涵盖以下核心方面： 1. **已知核心端点** - 登录与验证码接口（如获取验证码、手机号登录） - 每日九点申购接口（预约申购、提交订单） - 旅行耐力值相关接口（查询、更新） - 商品信息查询（酒品列表、详情） - 门店查询（附近门店、库存状态） 2. **请求签名 Header 规范** 明确必需的自定义请求头及其生成逻辑，包括但不限于： - `MT-Device-ID`：设备唯一标识，需固定不变 - `mt-k`：动态密钥或会话标识 - `mt-r`：请求随机数或时间戳相关参数 所有签名算法及参数构造规则详见 references/ 目录。 3. **登录 Token 管理** - Token 的本地安全存储机制（建议使用加密存储） - Token 过期检测与自动刷新流程 - 多账号场景下的 Token 隔离与切换策略 4. **多账号配置支持** 提供配置文件或数据结构示例，支持同时管理多个用户账号，并确保各账号请求独立、互不干扰。 5. **风控规避原则** - 请求间隔随机化：避免固定频率请求触发反爬机制 - 设备 ID 固定：同一设备应长期使用相同 `MT-Device-ID` - User-Agent 一致性：整个会话期间保持相同的 User-Agent，模拟真实客户端行为 - IP 地址稳定性建议（如使用固定出口 IP） 6. **错误处理规范** - HTTP 层错误码处理（如 401、403、500 等） - 业务层错误码解析与重试策略（如“申购已满”、“验证码错误”等） - 异常日志记录与告警机制 适用触发场景包括：「对接i茅台」「写api模块」「请求签名」「申购接口」「Token刷新」「端点列表」等。 详细端点文档与签名算法实现请参考项目内 references/ 目录。 淘宝搜索「AI灵匣」获取更多技术支持资源。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本