V2 版本 SDK版本(使用api-sdk调用的)

1.权限问题

{ “error_message”: “ApiKey is not allowed(acl)”, “exception”: “ApiKey is not allowed(acl)”, “error_code”: “gw.APIACLDecline”, “request_id”: “0b156f06jsl64lgx-40070077” }

可能原因有:

  1. 未开通openapi权限，
  2. 未申请单个appkey权限，
  3. 调用api的账号 不是主账号，也未被授权appkey查询权限。如果是自定义权限，需要勾选客户端选项。
  4. 查询时未输入关键参数，如apiKey, apiSecurity, appkey 等。

b.未申请单个appkey接口权限的（仅主账号可给appkey开通），如图进行申请（企业认证）
image.png

2.入参含有中文或特殊字符问题，需要urlEncode

errorCode=gw.unknow, errorMessage=Illegal character in query at index x : xxx

  • 1)一般是入参包含中文或特殊字符,需要先进行urlEncode。

3.签名丢失问题

errorCode：gw.SignatureMissing, errorMessage：Request need signature

  • 1)原因是中间层网络引起的，出现后，需要进行重试调用。

4.签名生成问题

  • 1)使用api-sdk的时候，sdk自动实现签名算法，调用者不必考虑签名参数。

  • 2)如果没有相应语言的api-sdk， 则需要自己实现签名，并带上签名参数。

    签名规则: https://developer.umeng.com/docs/67641/detail/67643

5.查询返回结果全为0

  • 1)可能因为有示例渠道和版本参数。
    请先将channel和version置空或注释掉， 如需配置 请写此app实际有的相关渠道和版本。
  • 2)可能因为查询日期范围写错。
    常见于新年度的新用户，如2019年新建的appkey，输入的日期是2018年的。

6. 错误提示Max retries exceeded Errno 110（常见于python-sdk）

aop.AopError: (‘API: 1/com.umeng.uapp/umeng.uapp.getAllAppData’, “HTTPSConnectionPool(host=’gateway.open.umeng.com’, port=443): Max retries exceeded with url: /openapi/param2/1/com.umeng.uapp/umeng.uapp.getAllAppData/2031666 (Caused by NewConnectionError(‘: Failed to establish a new connection: [Errno 110] Connection timed out’))”)

  • python request默认的重试次数比较少， 请使用requests.adapters.DEFAULT_RETRIES = 5 #

参考 https://blog.csdn.net/lb245557472/article/details/80239603

V1 版本 (地址是 api.umeng.com )

1. 提供的认证方式有，token验证和HTTP基本验证，共两种认证方式

只需选择其中一种认证方式即可。

2. 入参的日期格式为yyyy-MM-dd，共十个字符

如果是2018年1月1日，请写2018-01-01。

3. 应用事件 /events/daily_data

通过接口 /events/group_list 查询此appkey=5801e94ee0f55a576600447a 的内容， 其中没有group_id=59a77245c2367afc18de7480。 所以每个应用要重新查询 /events/group_list 获取到相关 group_id。

4. durations 使用时长，可以查询昨日及以前的数据。

5. 带有分页参数的，默认查询第一页的10条数据。

6.验证失败

{“code”:403,”error”:”This app is not allowed to access or not exist!”}

  1. 如果是用header里传Authorization ，可能是因为账号密码修改了。
  2. 如果是被授权的appkey，可能授权被取消，需要检查授权关系。