店铺开启 Open API 授权
花漾 TK 的一个核心功能是将 TK 店铺中的数据抓取到花漾 TK 系统中,并对其进行整理与分析。花漾 TK 与店铺的交互有两种方式,分别是基于 “RPA 机器人模式” 以及基于 “Open API 的调用方式”。为了能够使用 Open API 的调用方式,您需要对 TK 店铺进行 Open API 授权。
需要提醒您的是,目前仅支持所属国家为 马来西亚、菲律宾、新加坡、泰国、越南、印度尼西亚、巴西、墨西哥 的店铺,美区、英国、欧盟的店铺还需要一点时间,以下是店铺开启 API 授权的操作指引。
1、对TK店铺进行授权
首先请在花漾TK门户中打开店铺属性,点击“立即授权”,获取授权链接:
《对TK店铺进行授权》
请在TK店铺后台访问此授权链接。
如果是跨境店,请选择“Chinese mainland and the Hong Kong SAR (Cross-Border only)”:
《跨境店的授权》
如果是本土店铺,请选择店铺所属国家:
《本土店的授权》
然后请根据指引完成授权确认:
《TK店铺后台访问授权链接》
当店铺完成 Open API 授权后,有很多功能既可以通过 RPA 流程方式完成,也可以通过 API 调用方式完成,以下分别展开介绍。
2、通过 RPA 机器人方式执行流程
我们以定向邀约为例,可以选择通过 “RPA 流程方式” 执行。RPA 流程方式暨旧有的机器人模式,它可以是花漾浏览器中的内置流程,也可以通过其它浏览器中的花漾TK插件完成,本质上是通过浏览器访问店铺后台,然后通过机器人自动化的完成指定操作。
《以 RPA 方式执行流程》
RPA 流程方式的好处是:功能丰富,只要在店铺后台能够完成的功能,都可以通过 RPA 机器人自动化完成。
其弊端是:
- 执行流程时,要求浏览器必须打开(花漾浏览器会自动打开,其它安装花漾TK插件的浏览器需要用户事先手动打开)
- 如果流程执行过于频繁,会出现验证码(花漾会自动打码,但会影响执行效率)
3、通过 Open API 方式执行流程
同样以定向邀约为例,当店铺完成 Open API 授权后,我们可以选择通过 “API 方式” 执行。
《以 API 方式完成调用》
API 调用方式的好处是:用户无需打开浏览器,所有的调用请求全部在云端完成。
其弊端是:
- 受限于 TK 官方发布的 Open API 的功能是有效的,仅部分功能开放,其它功能还需要通过 RPA 方式予以补充
- API 调用次数有 QPS(每秒可调用次数)流控限制,当调用次数过于频繁时,会被 TK 官方进行拦截限制
4、QPS 流控限制
通过 Open API 访问店铺的某项服务时,TK 官方为了防止恶意访问,设置了非常严苛的 QPS 流控限制。QPS(Query Per Second)是指系统在一秒内最多能够接收或处理的请求数量,超过这个数值后,系统会进行限流,返回错误或拒绝服务。
花漾 TK 在调用 Open API 遇到 QPS 流控限制时的处理机制:
- 首先会等待若干秒后,重新尝试 API 的调用
- 当等待达到某个极限值且无法恢复访问时,会结束本次 API 调用任务
《遇到 QPS 流控限制的处理机制》
5、两种方式的选择
首先我们需要了解的是,TK 官方目前公开的 Open API 极为有限,因此在相当长的时间内,RPA 方式都是不可或缺的。
在此基础上,任何一个功能,凡是我们认为通过 Open API 能够获得更好的效果,默认方式都会设置为 API 方式,您只需要采用默认方式即可。