文档中心 > 汽车票接入说明

TOP接入详细说明

更新时间:2017/07/10 访问次数:6411

整体的接入流程

1、申请应用(具体联系各个业务接口人获取帮助,申请的appkey 请联系业务负责人加入到授权列表)
2、沙箱环境(测试环境,测试信息联系技术支持)调测基本接口
3、线上测试(采用正式的appkey 和地址 ),重点核查流程和钱款到账情况
4、应用单个机器试点上线,无问题,大面积上线

创建应用步骤:

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.sessionkey(店铺授权给appkey应用,生成sessionkey,表示允许此appkey可以访问此店铺中的数据),1个appkey可对应多个店铺(每个店铺对应一个sessionkey)

    沙箱环境获取sessionkey:需注册沙箱帐户http://mini.tbsandbox.com,  登录后打开http://mini.tbsandbox.com/tools/index.htm   进行授权获取sessionkey,(机票,火车票,汽车票需要找对接小二获取)

    正式环境获取sessionkey地址://open.taobao.com/apitools/sessionPage.htm?spm=0.0.0.0.5Fhlji,  输入appkey之后提交对应的店铺帐户登录生成sessionkey ,正式上线 sessionkey有效期3个月,过期需重新授权

3.url网关地址:

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

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

代码示例:
image

接口常见错误及处理方案

授权错误以及处理方案:
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.返回错误信息:invalid-sessionkey,sessionkey过期,请重新授权,请参照上方第六条
5.返回错误信息:isv.permission-api-package-limit,表示没有接口调用权限,请参照上方第四条

FAQ

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