1. 美团API对接基础准备
第一次对接美团开放平台API时,我花了整整三天时间才搞明白整个流程。现在回想起来,其实关键点就几个,但当时确实踩了不少坑。美团API主要分为外卖、到店、酒店等不同业务线,我们今天重点讲外卖业务中最常用的商品列表接口对接。
要调用美团API,首先得在美团开放平台(open.meituan.com)完成开发者注册。注册时需要准备营业执照、法人身份证等材料,审核通常需要1-3个工作日。审核通过后,在"应用管理"页面可以找到你的app_id和app_secret,这两个参数相当于你的账号密码,千万要保管好。
我建议先在沙箱环境测试,美团提供了完整的沙箱环境,地址是open-erp.meituan.com。沙箱环境不会产生真实订单,适合调试接口。等全部调通后再切换到生产环境,这样可以避免很多不必要的麻烦。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 参数拼接与签名生成
2.1 基础参数准备
美团API调用最关键的环节就是签名(sig)生成,这也是新手最容易出错的地方。签名需要三个基础参数:
- app_id:应用唯一标识
- timestamp:当前时间戳(秒级)
- app_poi_code:门店编码
时间戳获取要注意时区问题,我推荐用Java 8的ZonedDateTime:
java复制ZoneId zone = ZoneId.of("Asia/Shanghai");
long timestamp = ZonedDateTime.now(zone).toEpochSecond();
门店编码可以在美团商家后台找到,每个门店都有唯一的poi_code。这三个参数需要按特定顺序拼接成字符串,顺序错了签名肯定对不上。
2.2 签名算法实现
美团使用的是MD5签名算法,具体步骤是:
- 将参数按
app_id=xxx&app_poi_code=xxx×tamp=xxx格式拼接 - 在字符串末尾追加
&app_secret=你的密钥 - 对完整字符串做MD5加密
这里有个坑:拼接时参数值必须原样传递,不能做URL编码。我封装了一个签名工具类:
java复制public class SignUtil {
public static String gene
