公共FAQ

1 token不合法

问：调用美团企业版相关接口，返回提示token不合法是什么问题？
答：token是请求美团企业版接口的验证钥匙，由美团企业版生成提供给客户，若出现token不合法的提示，请进行以下确认
   1、是否已经有美团工作人员提供接口调用相关的token和secretKey，若美团工作人员未提供token，请联系美团企业版对接人员，索要token
   2、token是有线上环境和测试环境区分的，需要与调用的URL环境对应
   3、联系美团企业版对接的工作人员，确认提供的token是否正确
   4、若仍不能定位问题，联系美团相关开发人员协助处理

2 加解密异常

问：调用美团企业版人员/部门相关接口，通过美团企业版提供的secretKey进行数据加密后，调用接口，提示"content不合法"
答：1、联系美团企业版工作人员，确认加密密钥（secretKey）是否正确，secretKey与接口调用环境是否一致
   2、确认加解密方式是否正确，参考以下代码

/**
* 数据加密
*/
public void testEncrypt() throws Exception {
  //加密前的json
  String json = "{\"key\":value}";
  //使用美团企业版提供的AES工具
  AesCypher cypher = new AesCypher("美团企业版提供的secret key");
  //执行数据加密
  String encrypt = cypher.encrypt(json);
  System.out.println(encrypt);
}

/**
 * 数据解密
*/
public void testDecrypt() throws Exception {
  //加密后的json
  String json = "XXX";
  //使用美团企业版提供的AES工具
  AesCypher cypher = new AesCypher("美团企业版提供的secret key");
  //执行数据解密
  String decrypt = cypher.decrypt(json);
  System.out.println(decrypt);
}

3 无接口访问权限

问：调用美团企业版接口同步数据，提示"鉴权失败，无接口访问权限"。
答：该提示表明您调用的接口方法，没有开通使用权限，请联系美团企业版工作人员，提供企业id和您需要调用的接口，由美团企业版工作人员为您开通权限后，方可正常使用

4 怎样判断请求美团企业版接口是否成功

问：调用美团企业版接口，不知道是不是调用成功，怎么判断？
答：美团企业版所有对外接口有统一的返回格式，status:0，代表请求成功，不为"0"代表请求失败，失败时"msg"会提示失败原因。
   如下json为请求失败时的返回数据：
   {"status":11010, "msg":"ts缺失或ts时间已过期: ts缺失或ts时间已过期", "data":}
   如下json为请求成功时的返回数据：
   {"status":0, "msg":"", "data":{data数据格式请查看所调用接口文档内说明的返回数据格式}}

5 ts缺失或ts时间已过期

问：调用美团企业版接口，提示"ts缺失或ts时间已过期"？
答：美团企业版开放平台接口要求客户提供请求发起时的时间戳，用以保障请求的安全性，拦截风险，若调用端接收到异常提示："ts缺失或ts时间已过期"，可从以下几个方面排查
   1. 参数"ts"格式：时间戳（10位数字），即：将日期时间转换为秒级时间戳，例如：2023-07-28 16:12:00对应的秒级时间戳为"1690531920"
   2. 参数"ts"的过期时间为10分钟，若ts时间戳小于当前请求时间，且超过10分钟，美团侧认为请求存在风险，会拒绝本次请求
   3. 企业侧调用端服务部署的机器或者容器，确认时间是否准确，是否是标准时间