常见问题解决指引

1. 授权页面报参数错误:

  • 在授权相关 API 说明中的第 4 步中,要求从服务商管理页面跳转到第 4 步中的授权地址,其中跳转地址含有 3 个 query 参数,根据 HTTP GET 请求原理,GET 请求中的 query 参数,均要求 encodeURIComponent 参数才可正常进行传递,字节跳动服务器才能接收到正常的 query 参数,否则报参数错误;
  • 在授权相关 API 说明中的第 4 步,有些第三方服务商跳转地址为:https://open.microapp.bytedance.com/thirdparty/authorize;

这个地址并非文档中要求的跳转授权地址,正确跳转地址为:https://open.microapp.bytedance.com/mappconsole/tp/authorization。

请第三方服务商认真看文档,按照文档中的标准流程进行授权。

2. 调用代授权小程序业务接口调用报参数错误:

  • 一般是接口请求方式不正确,请第三方服务商认真看 API 文档,注意以下几点:

    a) GET 请求还是 POST 请求;

    b) 注意参数是 Query 还是 Body。

3. 调用授权相关 API 或代授权小程序业务接口报 IP 地址不合法

  • 一般公司级网络下属多个虚拟网段,每个研发人员的机器 IP 只是虚拟 IP,实际发出 HTTP 请求是会有一个公司统一的出口 IP,同时公司统一出口 IP 一般是多个,请第三方服务商在小程序第三方平台设置中,确保所有可能的公司出口 IP 都填入。

4. 调用代授权小程序业务接口调用报找不到相关第三方平台:

  • 一般是小程序 appid 和第三方平台 appid 混用,请第三方服务商注意区分小程序 appid 和第三方平台 appid。

5. code2session 接口报 “参数错误”:

  • 先排查 project.config.json 和 ext.json 是否正常,具体可以点 IDE 详情界面,如果能正常展示 appid(开发小程序 appid) 和 ext_appid(授权小程序 appid),则正常。
  • 其次,排查 authorizer_access_token 是否真的是通过上述授权小程序获取的授权 token。
点击纠错
评价此篇文档