什么是奇门
奇门云网关,奇门API网关,简称奇门,是一套标准。
原则上,一套标准是为了解决一个行业问题,而不是具体某一个企业一个集团的问题。
因此,奇门,跟淘宝、天猫、阿里巴巴上的店铺本没有太直接的关系,只是“恰巧”出自阿里淘宝之手。
但是,标准凭什么是阿里定呢,所以,类似的京东、拼多多、抖音也出了自己的网关。
奇门的作用
奇门既然是一套标准,一个平台。因此具有统一化,标准化的作用,减少各方沟通成本。
每一对甲乙双方对接N*N变为甲丙对接N*1
标准免费,平台不免费,购买在他们的云服务器,并部署上。
为什么要选奇门
理论上奇门做的事,谁都能做起来。也可以选其他平台。
然而,但是,因为出自阿里,如果要获取阿里系店铺或应用的更多数据,只能通过奇门。
此路是我不开,要把此路过,留下买路财。
奇门怎么用
看官方文档。
甲乙双方对接
常规的做法,双方出人,双方IT直接对接,使用双方的规则标准。
奇门的做法,只跟奇门对接,使用奇门标准,不关心其他方是谁,其他方需要对接授权即可。
因此,要读懂奇门的规则,名词,并对号入座,比较坑的是,奇门有平台有规则有文档,没人讲解,自己看文档吧。
有问题,发工单(聊天咨询,几乎不可能,毕竟聊天不方便考核奇门小二的工作量)
整个流程,要完成路径的连通,数据的连通。
总体流程:
入驻奇门
-> 选择官方场景,提交审核7天
-> 获取API\SDK
-> API实现、API自测、联调、发布上线 -> 配置授权 -> 对方调用
具体步骤:
一、入驻奇门开发者
当然是注册淘宝账号登录了,不同的是需要企业账号。
二、创建应用以及申请奇门appkey
TOP将所有开放的业务进行分类,选择自己的分类,需要资质校验,提供开发者信息,创建应用。
创建后可以查看App Key和App Secret,以及可用功能场景和api列表,需要单独申请激活。
应用,就是各种IT系统,在淘宝平台的影子。
开发者信息——营业执照,PRD,MRD
不同分类有不同要求,注意选择:
WMS
ERP(第三方服务商)
商家后台系统(商家自研),只处理自己体系下的一家或多家店铺
非淘ERP,不处理淘系订单,自己没有淘宝系店铺,也不处理其他淘宝系订单。
线下POS
线下ERP
商家自研应用,聚石塔内网互通使用 线下系统
三、创建场景
四、创建api,需要appkey,就是应用的appkey
五、联调、上线、 下线
联调和上线,发起方申请,接收方审核。 下线双方都可以自主发起,对方通过后生效。
名词
- TOP 淘宝开放平台(即Taobao Open Platform)
- ISP/ISV。ISP全称是Independent Software Vendors ,意为“独立软件开发商” 服务调用方。一个APP既可以是ISV,也可以是ISP,也可以都是。
- CP:CaiNiao Partner(菜鸟合作伙伴)
- PAC:菜鸟连接平台,菜鸟的一个内部系统,直接和合作伙伴进行交互(2017-5-30下线)
- LINK:全称为Logistics Integration NetworK,即物流集成网络,它是部署在物流云上,向全球菜鸟合作伙伴提供的数据交换的统一对接平台(PAC升级版)
- App key & App secret:指开发者在申请开发新应用时获得的由淘宝授予的应用程序接入账户和密钥。App key是应用的唯一标识,淘宝通过App key来识别应用开发者的身份。App secret是淘宝给应用分配的密钥,该密钥在一定技术条件下可保证应用来源的可靠性。
- Access Token:所谓授权,即获取 Access Token ,应用获取到了Access Token 即意味着取得了用户的授权,可以替用户向TOP(开放平台)请求用户的隐私信息(如商品、订单等)。这里的Access Token(Oauth2.0协议,当前应用均默认该协议) 即是原来“TOP授权协议” 时取到的SessionKey。
- CustomerId:
- api调用(调取奇门接口)的两种方式:(1)自己拼装请求,比较麻烦(2)使用官方sdk,推荐使用。
- 挡板联调:在双方进行联调时,对方还未对接API,此时调用方可以请求挡板帮来模拟请求对方,挡板会返回mock数据给请求方。这样请求方可以提前实现自测。使用挡板不需要做任何配置,直接使用即可。对于奇门仓储场景,只需要指定明customerId为mockCustomerId即可。