文档中心 > 基础技术

服务端对接文档

更新时间:2024/07/15 访问次数:2156

一、流程图

二、实现接口

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

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
返回
顶部