# 权限集常见排错指南

本文主要为第三方平台调用接口出现 480016100761003 的问题提供解决思路,帮助你定位及解决因权限无法正常调用接口的问题。其他错误码及其原因可查看全局错误码

# 48001

返回示例:{"errcode":48001,"errmsg":"api unauthorized, rid: xxx"}

出现 48001 错误的原因有以下几类:

1)API 功能未授权,请确认公众号/服务号/小程序/小店/视频号助手等账号已获得该接口权限。

第三方平台只是代公众号/服务号/小程序/小店/视频号助手等账号调用接口,如果这些账号本身尚未获得该接口的能力(例如有些接口需要完成认证才能获得,有些接口只开放给企业主体的账号等等,可查阅对应接口文档即可),第三方平台也不会有该接口的调用权限(特殊接口除外)。

2)调用接口的时候 Token 传错了。

  • 通常是把公众号/服务号/小程序/小店/视频号助手等账号的 access_token、第三方平台的 component_access_token、第三方平台的 authorizer_access_token 搞错了。
  • 例如某接口是小程序的接口,然后传了用公众号生成的 authorizer_access_token
  • 例如某接口是小店的接口,然后传了用小程序生成的 authorizer_access_token

3)如果只开放给服务商调用的接口,出现 48001 也有可能是公众号/服务号/小程序/小店/视频号助手等账号尚未将对应的权限集授权给第三方平台,解决方案参考下方 61007 的解决方案。

4)如以上几种原因都排除了问题尚未解决,请到社区-服务商专区发帖反馈处理。

# 61007

返回示例:{"errcode":61007,"errmsg":"api is unauthorized to component rid: xxxxx"}

出现 61007 错误的主要原因是:公众号/服务号/小程序/小店/视频号助手等账号尚未将对应的权限集授权给第三方平台。

1)服务商如何验证该账号是否已经将对应的权限集授予第三方平台?

可通过调用查询授权方账号信息接口查询,返回的 func_info 中是否包含了对应的权限 ID。

2)如何查询调用的接口隶属于哪个权限集 ID?

可查阅权限集说明文档

3)如以上原因排除了问题尚未解决,请到社区-服务商专区发帖反馈处理。

# 61003

返回示例:{"errcode":61003,"errmsg":"component is not authorized by this account, rid: xxxx"}

小程序登录接口,当 AppID 尚未授权给 component_appid,就会出现 61003 报错。

服务商应该存一份授权账号信息(可通过调用查询授权方账号信息接口查询),然后就可以知道调用接口传的 AppID 是否在授权账号列表里。

# 61009

返回示例:{"errcode":61009,"errmsg":"code is invalid rid:XXXXXXXX"}

code 无效,此时请开发者仔细检查:

1)是否在有效期内使用 code。

2)是否使用其他账号的 code(比如代 A 账号调用 API,实际使用的是 B 账号的 code)。

3)code 是否填错(比如 API 参数说明中需要使用授权码,实际使用的是预授权码)。

4)开发者可以通过getRidInfo接口自查 rid 信息。

# 其他注意事项

1)当开发者对已全网发布的第三方平台做了权限修改时,如果还没有覆盖现网全网发布的状态,则在授权页看到的权限仍将保持为现网的权限选项。

2)只要第一次全网发布(包括后续的修改后全网发布),当前在使用的用户永远不受影响,可以正常使用。

3)第三方平台新增勾选权限集,修改后审核通过并全网发布后,新授权的公众号或小程序授权时会增加新权限的申请,已授权的老用户旧有权限不影响,但新权限集需要老用户重新扫码授权后才生效。删除权限集同理。

4)随着时间的推移,平台可能会在权限集中新增更多的接口能力,此时不需要第三方平台重新进行全网发布,也不需要用户重新扫码授权,默认会生效。

5)当前仅支持公众号/服务号/小程序/视频号助手取消授权第三方平台,暂时不支持第三方平台主动取消授权。