接口类常见问题排查指南

本文主要为第三方平台开发遇到的相关常见问题提供解决思路,帮助您加速定位及解决问题。此外,还提供就如何在社区发帖高效解决问题提相关的建议,一起共建良好的开发者社区,保持社区良好的氛围。

自我排查

1、和权限集(关键字 api unauthorized)相关的问题请查看权限集常见排错指南

2、和component_verify_ticket相关的问题请查看component_verify_ticket常见排错指南

3、请求参数格式错误(关键字 format error 或者 invalid format),通常是json格式化的问题,要注意utf8 encoded和unicode encode以及清检查是否进行了json.dumps()或者json_encode()。请详细参考接口文档进行编码。

4、时间参数格式错误(关键字 invalid DateInfo 或者 date format error 等等),时间格式通常为时间戳以及通常对开始时间或结束时间都有要求,例如有的接口的结束时间最大为昨天而非今天,有的开始时间最早要在现在后的10分钟等等。具体请查看接口文档,严格按照接口文档描述的规则进行正确传参。

5、不合法的传参(关键字 invalid xxx)和 无效的账号(关键字 invalid xxx),遇到此些错误码,请请查看接口文档,严格按照接口文档描述的规则进行正确传参以及仔细检查当前使用的appid、secret、各种code等是否正确的。

6、对于接口返回{"errcode":-1,"errmsg":"system error rid: xxxxx"},通常是当时系统问题,请重试或者稍等一会再重试。如果重试无效请到社区发帖处理。

7、对于接口返回{"errcode":45009,"errmsg":"reach max api daily quota limit rid: xxxxxx"},则是当天的接口调用次数用完了。如果是小程序,可登录公众平台进行清空或者调用接口clear_quota进行清空(该接口同样适用于第三方平台代其调用)。

8、对于接口返回{"errcode":50002,"errmsg":"user limited rid: xxxxxx"},则通常是该小程序或者公众号被冻结了、注销了或者迁移了。可以自己使用手机扫该公众号或者小程序码进行验证即可。此外,50007的错误码则是账号冻结了,详情可查看公众帐号被系统冻结问题汇总

9、更多接口返回的错误码信息检索请查看返回码说明.

自我检索

在进行自我排查后仍然无法解决问题的情况下,可到社区发帖进行处理。但,为了快速解决问题,可在发帖之前进行相关搜索。按照经验,大部分的问题都可以在社区上找到解决方案。

1、访问社区https://developers.weixin.qq.com/community/develop/mixflow

2、在右上角进行搜索,如果是接口类型问题可按照错误码或者errmsg进行检索。

以及还可以进行筛选

发帖处理

在完成自我排查和自我检索之后,仍然无法解决问题则可及时发帖处理。并且提问时,请先表述你已经做了上述事情,这将有助于处理帖子的人员加速定位问题,也有助于建立你在社区的专业的印象。

1、接口类的报错请提供接调用接口返回的rid。

2、如果是调用接口没有报错,只是返回的结果有误或者有疑问。请提供相关的appid、请求参数、请求时间、回包等信息。

3、如果是第三方平台的问题请发帖的时候提供第三方平台的appid(必不可少),如果还涉及公众号或者小程序,也请一并提供其appid。此外,还请尽可能提供更多的报错信息(如有相关截图也请一并提供)、错误日志、发生的时间等等。

4、关于发帖时的问题描述的建议:

  • 请使用明确而有意义的题目,这有利于帖子被更及时地关注到

  • 问题应明晰,漫无边际的问题会被标记为无效问题

  • 请不要刻意标明问题紧急。如果是平台的故障则会被监控到且在及时处理中,请耐心等待即可

  • 请不要重复发帖子。如果当时平台出现了故障影响了您的业务,确实也是着急的事情,也请不要重复发帖子,相关进展会在原帖子及时回复处理即可;如果没有及时回复则可能是尚在处理中,请耐心等待即可

  • 请尽量不要私聊发问题。因为如果您私信发给某个同学,那么私信则只有TA才能看到以及进行处理,当遇到该同学休假或者忙其他事情的时候,您的问题将会得不到及时的处理;建议还是在社区上发帖子,因为社区的帖子会被多个官方人员看到并处理,更加有利于您的问题的及时被解决

  • 问题解决后追加一条简要说明。如果您的问题已经被解决了(个别情况是如涉及隐私信息会私信进行处理)请在原帖子上表述出来,这有助于帖子处理人员及时了解进展,以及这也将帮助其他人在搜索相关问题时能看到真正解决问题的方案,从而也让社区的人员受益。