401 unauthorized 错误主因是签名生成错误：需按 key 字典序拼接参数（含 app_key、timestamp 等），timestamp 为秒级且与美团时间差≤5分钟，签名原文末尾拼 app_secret 后 md5 再转大写；订单状态须用美团固定码如 paid、warehoused，严格单向流转；category_id 和 brand_id 必须为数字 id，非名称；curl 需禁用 ssl 验证并设置指定 ua。
401 Unauthorized 错误：签名生成不对，不是 token 过期
调用 meituan:// 或开放平台 /api/retail/order/create 等接口时返回 401 Unauthorized，90% 是签名（sign）算错了，而不是 app_key 没配或 token 失效。美团要求按特定顺序拼接参数、转小写、MD5（非 HMAC）、再转大写——漏掉任意一步都会失败。
实操建议：
- 所有请求参数（含
app_key、timestamp、nonce、业务字段）必须先按 key 字典序升序排序，再拼成key1=value1&key2=value2形式 -
timestamp必须是秒级时间戳（time()），且与美团服务器时间差不能超过 5 分钟，建议每次请求前调用一次/api/common/time校准 - 签名原文末尾要拼上
app_secret，例如"app_key=xxx&nonce=yyy×tamp=zzz"<your_app_secret></your_app_secret>，然后strtoupper(md5($str)) - 别用
http_build_query()直接拼——它会 URL 编码空格、中文等，而美团要求原始值（如商品名不编码），得手写拼接
订单同步失败：status 字段映射错，不是状态没推
你发了 /api/retail/order/status/update，响应是 200，但美团后台订单状态没变——大概率是传的 status 值不符合美团定义。他们不用 “paid”、“shipped”，而是固定字符串，比如“已付款”对应 PAID，“已出库”对应 WAREHOUSED，大小写敏感，且部分状态仅允许单向流转。
实操建议：
- 查文档时认准「即时零售-订单状态码」表格，不是通用电商 API 的那套；
CONFIRMED和CONFIRMED_BY_MERCHANT是两个不同状态，后者需商户确认后才可触发配送 - 推送
DELIVERED前，必须确保已先推过SHIPPED；跳步会静默失败，响应里不报错，但日志显示 “invalid status transition” - 测试时用沙箱订单号（以
MTS开头）调用/api/retail/order/query查实时状态，别只信回调
商品同步卡在审核：category_id 不是类目名称
调 /api/retail/item/sync 返回 success: true，但商品在闪购后台一直显示「审核中」，点进去提示「类目不匹配」——问题几乎都出在 category_id。它不是你填的“生鲜蔬菜”或“水果”，而是美团分配的 8 位数字 ID（如 10000123），且必须和你签约开通的类目完全一致。
实操建议：
- 登录闪购商家后台 → 商品管理 → 类目管理，点开你的主营类目，URL 里找
categoryId=后面的数字，复制使用；不要从其他商家截图或历史文档里抄 - 一个店铺只能同步其签约类目下的商品，跨类目（比如签约了“乳饮冲调”却传“酒水饮料”的
category_id）会导致审核卡死，且无明确报错 -
brand_id同样是数字 ID，需通过/api/retail/brand/list接口查，不能填品牌汉字名
cURL 超时但 Postman 成功：SSL 验证和 UA 被拦截
PHP 用 curl_exec() 调用闪购 API 一直 timeout 或 SSL certificate problem，但同样 URL 在 Postman 或 curl 命令行能通——核心是美团网关对 User-Agent 和 SSL 配置更敏感。
实操建议：
- 必须显式关闭证书验证（
CURLOPT_SSL_VERIFYPEER => false）且关闭 host 验证（CURLOPT_SSL_VERIFYHOST => false），生产环境也得关，美团用的是自签中间证书 - 设
CURLOPT_USERAGENT => 'Meituan-PHP-Client/1.0'，空 UA 或默认curl/7.x会被限流甚至拒绝 - 超时设为
CURLOPT_TIMEOUT => 30，别用默认 0（无限）；美团部分接口（如库存查询）平均响应 800ms，但偶发到 2s+，设太短容易误判失败
闪购 API 对参数顺序、时间精度、状态流转路径非常较真，细节错一点，就卡在某个环节不动，日志又不明显。盯住签名、类目 ID、状态码这三处，比调通整个流程还关键。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
