文档中心 > 基础技术

服务端对接文档

更新时间：2024/07/15 访问次数：1445

一、流程图
二、实现接口
三、通用错误码以及对应的解决方案
四、权限申请
五、SDK
六、FAQ

一、流程图

二、实现接口

服务端只需要实现以下两个接口即可。

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，前端问题请截图控制台报错信息。

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问