基础技术
一、流程图
二、实现接口
服务端只需要实现以下两个接口即可。
1. 请求SecToken(ieid,oeid,登录态)
前端组件请求服务端，服务端要求完成：
1）商家登录态判断，获取对应的openId；
2）使用TOPAPI taobao.top.sec.token.get 调用TOP获取SecToken数据；
入参 |
描述 |
oeid |
框架传入的oeid，透传即可 |
ieid |
框架传入的oeid，透传即可 |
open_id |
商家对应的open_id |
出参 |
描述 |
result_code |
响应编码 |
token |
SecToken |
result_msg |
失败详情 |
3）把SecToken、openID返回给前端组件。
2. 请求获取ClientToken(SecToken,SessionKey)
前端组件请求服务端，服务端要求完成：
1）商家登录态判断，获取商家对应的sessionKey；
2）使用TOPAPI taobao.top.client.token.get 调用TOP获取TopToken数据。
入参 |
描述 |
sec_token |
框架传入的sec_token，透传即可 |
session |
授权SessionKey |
出参 |
描述 |
result_code |
响应编码 |
token |
SecToken |
result_msg |
失败详情 |
三、通用错误码以及对应的解决方案
错误响应demo如下
{
"error_response": {
"code": 15,
"msg": "Remote service error",
"sub_code": "4100:Oeid-error",
"sub_msg": "Oeid is illegal",
"request_id": "772psdgk52u8"
}
}
sub_code |
问题原因 |
解决方案 |
4200:illegal-user |
非法用户 |
SecToken接口和topToken接口用户不一致 |
4300:appkey-changed |
appkey 不匹配 |
SecToken接口和topToken接口Appkey不一致 |
4300:host-error |
域名错误，端域名仅支持端API使用 |
? |
4100:openId-error |
OPEN ID 有误 |
? |
4100:Oeid-error |
OUT ID 有误 |
返回给组件重新刷新指令 |
4100:Ieid-error |
internal id 有误 |
返回给组件重新刷新指令 |
四、权限申请
联系开放平台小二开通API调用权限。
五、SDK
开发版SDK下载（提供Appkey，联系平台小二弘智开通，直接在开放平台后台下载）:
https://work.open.taobao.com/open-console-ec/你的Appkey/app_sdkDownload
六、FAQ
请先根据上文《通用错误码以及对应的解决方案》排查问题。
1. 生成的Oeid 或者Ieid有误，类似下面的错误信息，怎么解决？
"oeid": "defaultToken3_init_callback_not_called@@http://localhost:5173/web/@@1718615945148",
答：
1）如果是千牛客户端，则联系官方小二确认是否已加过权限。
2）检查测试机器所属的网络环境：
① 如果开启了代理，则关闭代理再试；
② 如果所处的网络限制了外网访问，则需要先外网访问权限，或者对淘宝域名加白。
2. 报错：该子帐号无此操作权限, 请通过主帐号设置开通相应权限（应用）
答：到子账号平台开通权限 https://open.taobao.com/help?spm=a219a.14658873.0.0.5b524dc1w1ogn6&source=search&docId=2410&docType=14
3. 报错：该子帐号无此操作权限, 请通过主帐号设置开通相应权限(权限组)
答：可以先切换到主账号调用接口.
4. 报错：无权限打开此功能
答：请联系官方小二配置。
5. openId如何获取?
答：从授权上下文获取，openid为卖家openid，非买家openid。授权参考文档https://open.taobao.com/doc.htm?docId=102635&docType=1
6. SecToken的ieid和oeid从哪里获取？
答：组件sdk 会将这两个参数传给前端前端组件，前端组件在传给后端.
如上述问题未能解决
请F12观察前后端相关报错，并提供完整的报错信息给平台支持解决。
后端问题请带上错误码和requestID，前端问题请截图控制台报错信息。