文档中心 > 旅行用车接入说明

用车TOP接入详细说明

更新时间:2016/11/29 访问次数:1411

创建应用步骤:

1.登录open.taobao.com,登录后右上角-个人资料-应用管理-点击 创建应用

image

2.选择对应的业务线,申请权限,如需选择飞猪-系统商,请先咨询open.alitrip.com在线小二允许后再申请)

image

3.提交开发者信息,可联系业务经理,协助推动审核进度

image

4.审核通过后,卖家可以登录开放平台,点“应用管理“中根据自己业务场景在”功能场景“列表里面找到对应的权限包申请权限。

image

5.创建成功后,常用到的功能菜单如下图

a)SDK下载,SDK是由程序通过API的结构、业务数据等自动化生成的代码包,下载后直接引用到项目中直接可以使用对应的类方法

   b)授权管理,添加卖家帐户名称,提高安全性(必须设置)

   c)沙箱环境管理,沙箱环境测试使用

   d)服务托管报备,是为了加入聚石塔托管(机票必须托管)

   e)应用安全指数,可提高应用安全等级

   f)IP白名单,应用调用API时的服务器IP地址,提高安全性

   g) 概况菜单中,设置回调url地址,应用发布上线(必须设置)

image

6.调用说明

设置完成后,下载SDK后引入到自己的项目工程中,进行沙箱测试,主要用的到的系统级参数

1.appkey,secret(应用详情中查看[沙箱,正式])(同一个应用可以多个店铺使用)

2.url网关地址:

    正式环境:http://gw.api.taobao.com/router/rest

    沙箱环境:http://gw.api.tbsandbox.com/router/rest

代码示例( 以JAVA为例):

public class TopAPITest {

    private final static String url = "http://gw.api.tbsandbox.com/router/rest";
    private final static String appkey = "4272";
    private final static String secret = "0ebbcccfee18d7ad1aebc5b135ffa906";

    public static void main(String[] ary) throws Exception {
        TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
        AlitripCarOrderConfirmRequest req = new AlitripCarOrderConfirmRequest();
        OrderConfirms obj117854 = new OrderConfirms();
        obj117854.setConfirmTime("demo");
        obj117854.setDriverCarName("demo");
        obj117854.setThirdOrderId("demo");
        obj117854.setDriverName("demo");
        obj117854.setDriverCarNo("demo");
        obj117854.setOrderId("demo");
        obj117854.setDriverTel("demo");
		obj117854.setConfirmType(0);
        req.setParamOrderConfirm(obj117854);
        AlitripCarOrderConfirmResponse rsp = client.execute(req);
        ApiResults result = rsp.getResult();
    }

}?

接口常见错误及处理方案

授权错误以及处理方案:
1.返回错误信息:Authorization of application has been frozen…表示appkey因调用收费接口已经欠费,需登录open.taobao.com 交费解冻
2.返回错误信息:代理商** is forbidden to login to apply名称 according to app user-whitelist,表示需要设置授权账户,请参照上方第五条
3.返回错误信息:appkey callback url is invalidate,需要登录open.taobao.com设置appkey基本信息中的回调地址,请参照上方第五条

接口调用常见错误以及处理方案:
1.返回错误信息:您的ip 192.**.*.*禁止聚石塔外调用,请将您的程序发布到聚石塔内,从塔内发起调用
2.返回错误信息:包含ip-whilelist,表示需要设置ip 白名单,请参照上方第五条
3.返回错误信息:accesscontrol.limited-by-api-access-count,每天调用次数限制100万,流量用完,请登录open.alitrip.com,帮助支持中心提交申请流量
4.返回错误信息:isv.permission-api-package-limit,表示没有接口调用权限,请参照上方第四条

FAQ

关于此文档暂时还没有FAQ
返回
顶部