服务端开发

收藏

我的收藏

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

问题反馈方式

当调试接口遇到问题需要寻找官方帮助时，可以通过开发者社区提问。

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

如果是接口方面问题，提问前请务必先参照我们提供的接口模板，确认自己的请求方式、接口地址、请求参数等是否有误。

确认需要协助排查时，需要提供额外信息，包括但不限于：请求大致时间、请求接口地址、请求参数、logid（http response header 中 X-Tt-Logid 字段）、具体报错表现、可否复现等，越详细越好。

注意：logid 获取方式：

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

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

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

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

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

• GET 请求还是 POST 请求。
• 注意文档中描述的接口参数格式是 Query 还是 Body（form-data）还是 Body（json）。
• 检查必填参数是否遗漏，参数名是否正确。

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

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

code2session 相关

当接口报 “code 错误” 或者 “anonymous_code 错误” 时，一般是以下 3 种情况：

• code / anonymous_code 过期。
• code / anonymous_code 被重复使用。
• authorizer_access_token 对应的授权小程序 appid 和 code / anonymous_code 对应的授权小程序 appid 不一致。 先排查 project.config.json 和 ext.json 是否正常，具体可以点击 IDE 「详情」tab，如果能正常展示 appid（开发小程序 appid） 和 ext_appid（授权小程序 appid），则正常。 分别排查 authorizer_access_token 对应的授权小程序 appid 和 code / anonymous_code 对应的授权小程序 appid。

支付及订单相关

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

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

1. 请先检查进件状态，只有在进件完成后，SALT 才会展示。
2. 需要第三方应用先开通支付服务权限，才能进件。
3. 关于进件接口说明，详见文档服务商进件。