文档中心 > TVS文档

创建应用与调用TOP接口

更新时间:2019/02/12 访问次数:3073

在接入精灵语音服务时,某些能力会需要开发者调用特定的接口来使用,由于这些接口是挂载在 淘宝开放平台 (Taobao Open Platform; TOP) 中对外开放的,因此需要先在淘宝开放平台中创建TOP应用,并使用此TOP应用的凭证信息来调用接口。本文档将介绍如何创建淘宝开放者帐号与应用,并测试淘宝接口的可用性。

创建淘宝开发者帐号

请参照淘宝开放平台新手指南文档,至平台控制台完成帐号创建,并登录TOP申请成为开发者。

创建应用

由于天猫精灵语音服务 (TmallGenie Voice Service; TVS) 目前尚未完全对外进行开放,需要TVS窗口人员协助创建应用。在确认帐号创建完成后,请给予TVS窗口以下信息:

  • 开发者淘宝会员名
  • 欲创建的应用名称
  • 回调地址 (回调地址说明,可选,后续开发者可随时在开放平台控制台变更)

应用创建后TVS窗口会通知开发者,此时开发者将可以在开放管理页面中看到该应用的相关信息。

测试应用

任何TOP应用都具有访问淘宝基本系统工具的权限。因此,在应用创建完成后,您可以参考API调用方法SDK使用说明对在系统工具列表中的接口进行调用。

调用示例

首先先在TOP平台建立应用。该应用的app key与app secret可直接在应用详情页查看。假设此应用凭证信息为:

  • app key: 24979538
  • app secret: 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代码进行调适。

FAQ

关于此文档暂时还没有FAQ
文档标签:
TOP
返回
顶部