在接入精灵语音服务时,某些能力会需要开发者调用特定的接口来使用,由于这些接口是挂载在 淘宝开放平台 (Taobao Open Platform; TOP) 中对外开放的,因此需要先在淘宝开放平台中创建TOP应用,并使用此TOP应用的凭证信息来调用接口。本文档将介绍如何创建淘宝开放者帐号与应用,并测试淘宝接口的可用性。
请参照淘宝开放平台新手指南文档,至平台控制台完成帐号创建,并登录TOP申请成为开发者。
由于天猫精灵语音服务 (TmallGenie Voice Service; TVS) 目前尚未完全对外进行开放,需要TVS窗口人员协助创建应用。在确认帐号创建完成后,请给予TVS窗口以下信息:
应用创建后TVS窗口会通知开发者,此时开发者将可以在开放管理页面中看到该应用的相关信息。
任何TOP应用都具有访问淘宝基本系统工具的权限。因此,在应用创建完成后,您可以参考API调用方法或SDK使用说明对在系统工具列表中的接口进行调用。
首先先在TOP平台建立应用。该应用的app key与app secret可直接在应用详情页查看。假设此应用凭证信息为:
24979538
da202********de2ee15e
则我们可以透过以下代码调用taobao.time.get
接口:
String url = "https://eco.taobao.com/router/rest"; String appkey = "24979538"; String secret = "da202********de2ee15e"; TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); TimeGetRequest req = new TimeGetRequest(); TimeGetResponse rsp = client.execute(req); System.out.println(rsp.getBody());
结果会是淘宝系统目前的时间,格式为yyyy-MM-dd HH:mm:ss
的字符串。
如果等待TVS窗口的等待时间较长,可以自行在创建应用的步骤中选择**其他**、**其他**以建立不包含TVS服务权限的应用,后续再请TVS窗口进行权限调整。
因为所有TOP应用都能够调用系统工具中的接口,因此可先使用这些接口对应用与TOP代码进行调适。