第三方平台
接口说明

服务端开发

最后更新于 2021-07-29

文档介绍

该文档总结了服务商在调用第三方平台服务端 API 过程中常遇到的问题。

1. 问题反馈方式

当调试接口遇到问题需要寻找官方帮助时,可以通过服务商对接群或者开发者社区提问。

提问时,请给出有效排查信息,至少包括:第三方应用 appid。

如果是接口方面问题,需要提供额外信息帮助排查,包括但不限于:请求大致时间、请求接口地址、请求参数、logid(http response header 中 X-Tt-Logid 字段)、具体报错表现、可否复现等,越详细越好。

注意:logid 获取方式:

2. 小程序授权页面报 “参数错误”

  • 在授权相关 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

请服务商严格按照文档中的标准流程进行授权。

3. 调用代授权小程序接口调用报 “参数错误”

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

    a) GET 请求还是 POST 请求。

    b) 注意文档中描述的接口参数格式是 Query 还是 Body(form-data)还是 Body(json)。

    c) 检查必填参数是否遗漏,参数名是否正确。

4. 调用代授权小程序接口调用报 “找不到相关第三方应用”

  • 一般是小程序 appid 和第三方应用 appid 混用,请注意区分小程序 appid 和第三方应用 appid。

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

  • 先排查 project.config.json 和 ext.json 是否正常,具体可以点击 IDE 【详情】tab,如果能正常展示 appid(开发小程序 appid) 和 ext_appid(授权小程序 appid),则正常。
  • 其次,排查 authorizer_access_token 是否真的是对应的上述授权小程序的接口调用令牌。

6. 支付及订单相关

请先看 小程序担保支付 相关文档,确保了解背景。

  • 如果第三方平台上展示的第三方应用 SALT 字段为空字符串,注意以下几点:

    a) 请先检查进件状态,只有在进件完成后,SALT 才会展示。

    b) 需要第三方应用先开通支付服务权限,才能进件。

    c) 关于进件接口说明,详见文档服务商进件

    d) 在常见问题中也有提示,详见文档如何获得支付秘钥

点击纠错
评价此篇文档