速卖通AE平台+聚石塔+奇门 完整教程V2

公司是跨境电商,在阿里马马的速卖通平台上开有店铺,并且基于速卖通开放平台,自主研发了ERP系统,居今已有3年多的时间了,一直很稳定。

今年初,速卖通AE开放平台改版,并入淘宝开放平台中,我们的麻烦就开始了。。。从最初始的申请资格开始,一步一步的研究、自测。到最近才小有成就。下面就把一路走来填的坑分享下,希望给新人指点吧

使用速卖通AE新版开放平台,我们先看看需要哪些条件

1,要有一个企业级别的支付宝帐号,注:必须是企业级别。

2,要有软著,就是软件著作权证书

这2个都有了,才能去申请。

申请类型有2种

1,商用授权,适合专门的软件公司

2,自研授权,适合电商公司有独立研发团队

我们公司申请的是自研类型

1,创建应用

这个环节用于获取AppKey和Secret,后面获取令牌用的。这里要说下和老版的区别

1、新版本没有Refresh和Access令牌的区别,只有Access令牌。正式发布后,这个令牌的期限是一年(相比老版本24小时的时限,时间延长了好久,给个赞)

2、我们使用SDK的时候,有的方法中,参数名称是SessionKey,其实就是这个令牌(官方文档从来不说,就是不告诉你)

2,授权报备

这里是要绑定一个速卖通的店铺,你会得到一个cn前缀的字符串,记住这个字符串,后面会很有用

3,下载SDK。这是淘宝官方提供的,各版本都有。我们使用的是Net版本。

注:这里最后下载源码加载至项目中,方便调试。因为后面有个坑,你不进入源码调试,到死都不知道怎么回事?!(官方就是不说)

注1:SDK我们是可以随时编译下载的

注2:如果我们使用自定义场景,创建成功若干API的话,重新编译下载SDK,会发现输入输出参数,已经帮我们定义好类了。我们还是像官方场景那样,直接使用即可

注:这里最后下载源码加载至项目中,方便调试。因为后面有个坑,你不进入源码调试,到死都不知道怎么回事?!(官方就是不说)

4,托管服务器

这里可能也不需要,我是直接托管的

5,设置白名单

一般设置3个IP地址就可以了

106.11.,没错,就是*.*,这个IP是奇门要求的

106.14.,这个是聚石塔里的

注:聚石塔里的数据,输入输出都要经过奇门,所有只要你想用AE平台,先申请聚石塔吧

115.233,这个是我们自己的服务器IP。如果你还没有买聚石塔的服务器,平台可以给你3天的塔外测试。就是这个IP地址

6,绑定测试帐号

这个帐号就是之前申请的速卖通店铺帐号,直接用这个帐号测试就可以。只有3天时间,但过期了可以延长的

7,设置回调地址

必须要设置的环节。用于获取AccessToken令牌

好了,通过上面的几步,准备工作算是完成了。下面,我们正式写代码,还是一步一步来

注:以aliexpress.logistics.listlogisticsservice,获取物流服务列表的API为例

1,调用AE平台的API。这是我们的关键业务,建议直接使用官方提供的SDK即可,简单方便。

其中

AliApiUrlPrefix是AE开放平台的调用地址:http://gw.api.taobao.com/router/rest。

AppKey和AppSecret是之前申请应用时得到的

这步一般是都可以调通的。注:此时还没有塔和奇门

2,下面就开始搭塔了,就是聚石塔。

聚石塔可以理解为阿里云,即一个独立的操作系统,你上面写好的程序要部署的吧,你必须要部署在聚石塔里才可以(别问我为什么,官方说的)

2.1,部署好以后,直接调用塔里的程序,还是通的。有人会问,即然通了,还要奇门干啥

现在通了,是我们申请的塔外测试的原因。正式发布的程序,还是要通过奇门才能调用塔里的数据

2.2,塔里部署成功后,达到能访问返回正确数据即可

3,下面就要讲重头戏了:奇门

什么是奇门?奇门就是外部程序和聚石塔必须要经过的一道桥梁。没有奇门,你就没门进去,根本访问不了聚石塔里的应用

3.1,奇门的位置

云工作台->业务系统构建&集成

3.2,场景选择

场景包含2种:自定义场景和官方场景。个人建议先选择官方场景,因为它内置了传入和传出的参数格式。

我们肯定会自定义场景(因为官方场景只提供的30%的API)

3.3,官方场景API列表

场景由API组成,每个方法都需要配置和发布(发布前要自测通过+验签)

3.4,官方场景API配置(划重点了,这里有个大坑)

3.4.1,配置请求映射

这个坑,研究了2小时,得出结论

这个地址是聚石塔里,你程序的部署地址

注1:是到方法名称级别

注2:Net版本,可以部署成WebAPI程序(推理得出:WebService也可以,Handler也可以)

3.4.2,请求参数

记住这个格式,后面肯定会用到

3.4.3,请求Demo

这是标准的参数格式,含输入和输出。也要记住,后面会用到

3.4.4,响应参数(即输出参数)

记住+1

3.4.5,请求和响应demo

这个最开始没有注意,导致后面开发耽误了时间。划重点了

注意验签Demo的返回格式

3.4.6,自测API

到这个环节,就可以开始测试了。

注1:返回格式有2种:XML和Json。一般选择Json

注2:Query id,这个参数是cn的那个字符串,但在这里没有影响,传啥都可以

注2.1:这个参数我认为在发布后相当有关系。一个AppKey可能同时关联多个店铺,这是用来区分店铺信息的。知道是哪个店铺,才能获取对应店铺的令牌(令牌就是AccessToken,就是SDK中的SessionKey)

注3:有的API方法,参数有个param1的参数。这个怎么理解呢?这个可以理解成方法需要的其他参数内容,都放到这里,Json格式传入。特别说明:它是有格式要求的,就是前面的输入参数格式

到这时,你会发现各种调试失败。。。但官方给出的错误码并没有什么卵用。下面重新讲一遍正确的姿势,小板凳搬好

3.5,正确做法

3.5.1,先定义返回Model基类,按照3.4.4,响应参数定义即可(还有验签的格式)。相当于每个方法都会返回这些属性值

这个类,同时还参照了奇门的输出参数定

3.5.2,修改Service层的方法。

主要修改输出参数,改成什么格式呢?就是我之前提到的,验签Demo的那个格式。相当于方法必须返回验签Demo格式才行。否则,打死都通不过

看到木有?无论能否返回正确的数据,它要的验签格式。你必须返回。

而且你发现木有,验签的格式不光属性,属性值也要求完全一致。

3.5.3,Controller层方法(继续划重点,又一个大坑)

注1:这里先解释下什么是验签,作者之前也理解错误,现在更正下:验签就是平台给塔里程序发个错误的请求,平台要接收到它认为正确的数据,验签就通过了,其实就是这么简单)正确的数据就是上图的数据,即是验签Demo的格式(属性值也相同)

注2:再看看Net版本的验签,你会发现它的一个参数是System.Web.HttpRequest。我找了好久也没找到在哪里传进去,百思不得其解。后来才发现它不是在Service层的,是在WebAPI的Controller层

看,这就是验签。是不是有种恍然大悟的感觉。而且这是Controller层完整的方法。包括验签+调用Service层+返回格式

3.5.4,外部程序调用?

验签通过以后,就可以发布了。发布成功,意味着外部程序可以直接使用了。注意:不是直接调用塔里的程序,塔的所有数据,都要通过奇门

这里根据奇门SDK写的方法,外部程序最后调用的是这个方法。不是前面我们写的那些

3.6,自定义场景

昨天也把自定义场景调试通过了。它和官方场景有什么区别呢?如下所示

a,方法名称自行定义

b,输入参数自行定义

c,输出参数自行定义

d,验签格式不可定义(必须按照官方的格式)

其他的没有什么坑,验签通过就可以发布(有个审核的操作,基本都通过的)

3.7,安全扫描

整个应用发布前,会有一个安全扫描的过程,官方说是3小时(实际要超出这个时间,都问题不大)

最后总结下

1,官方的文档要认真看,每句话都有它的含义(为毛他们不明说呢,非要我们自己猜)

2,所有的环节都是互相关联的,一步配置不对,就都有影响

3,申请令牌的程序是可以部署在塔外的

4,官方场景或自定义场景中,每个方法的验签返回格式不是都相同的。要注意,必须和验签格式完成相同才可以

5,多店铺时,关于SessionKey(即AccessToken)如何使用?每个店铺都有id(就是cn123456)的字符串,这是可以通过参数传进去的。这样可以在塔里部署一个txt文件,定义好id和令牌的关系。这样就可以根据Id获取令牌了

附:

作者创建一个QQ群:558905448。用于分享和交流Net开发经验,欢迎加入.进群请标明:程序员

原文地址:https://www.cnblogs.com/xiyang1011/p/8481768.html

时间: 2024-11-05 17:30:40

速卖通AE平台+聚石塔+奇门 完整教程V2的相关文章

速卖通流量入口有哪些,速卖通怎么引流?

有足够多的流量是提升店铺成交量的前提,今天要和大家分享速卖通怎么引流?速卖通站内.站外流量入口有哪些? 一.速卖通站内流量 1.速卖通橱窗推荐 速卖通平台在卖家达到一定等级或者在一些特殊活动中会赠送橱窗位.与线下商店靠近窗户或门口的橱窗位置相似,被橱窗推荐的产品将在同等质量的产品中优先排名,近一步提升曝光.合理利用这一点也能获取不菲的免费流量. 挑选好橱窗产品是关键中的关键,一般可以结合以下几点来挑选橱窗产品:主打产品.热销产品.新出产品.或者结合季节和展会. 需要强调的是,橱窗在速卖通平台的买

速卖通新店运营必看的6个思路

1. 打破原有思路,优化产品结构. 杂货时代已经过去了,再想凭借多发布产品来获取更多流量已经不可能了,比如现在在淘宝上,谁还记得淘宝的第一个金冠店柠檬绿茶呢?所以,在新形势下,一定要做到优化产品结构,重点打造核心产品,而不是盲目铺货,胡乱上新. 2. 提高产品质量,精选高质产品. Ebay已经因为整个平台产品品质不高而开始没落,Amazon则因为产品品质和物流时效得到越来越多的顾客的青睐,速卖通虽然凭着起步时蛮干抢粮的方式,从新兴国家市场拔得头筹,但下一步的发展,对产品品质方面的要求会越来越高,

分享下速卖通api的java的入门代码

package com.print.base; import java.io.*; import java.math.BigInteger; import java.net.URL; import java.net.URLEncoder; import java.util.*; import javax.crypto.Mac; import javax.crypto.spec.SecretKeySpec; import net.sf.json.JSONArray; import net.sf.j

速卖通 排序规则解析

排序规则解析 一.搜索排序的原则 AliExpress搜索的整体目标是帮助我们的买家快速找到想要的商品并且能够有比较好的采购交易体验,而搜索的排名的目标就是要将最好的商品.服务能力最好的卖家优先推荐给我们的买家,谁能带给买家最好的采购体验,谁的商品就会排序靠前. 在排序过程中,我们将始终坚持公平的原则,对于所有的卖家采取相同的标准,给予表现好的卖家更多的曝光机会,降低表现差的卖家曝光机会甚至没有曝光机会.我们提倡卖家间公平竞争,优胜劣汰,能够提供最好的采购体验给我们的买家,让更多的买家满意愿意来

速卖通API开发步骤

关键字段说明 1.appKey和appSecret appKey是app的唯一标识,appSecret是app的密钥,它们相当于用户名和密码.注册app之后就会生成一个appKey和appSecret,请妥善保存. 2.code 即临时令牌.当用户在开放平台访问app前,需对app进行授权,用户授权后,app方可访问用户的隐私数据.用户在完成授权之后,会跳转到redirect_uri,并带上临时令牌code,app再用code从开放平台后台接口换取access_token.code为一次性令牌,

速卖通新手快速入门手册之一认识物流

写在帖子之前的话 最近有一大批朋友想做速卖通或者有的刚做速卖通,遇到了不少问题,都来问我,我觉得这个是一个好的趋势,说明跨境电商的市场正在走向成熟,相关配套也会越来越完善.但是也是说明竞争将会前所未有的激烈了. 我很想一个一个的为我的朋友耐心的回答所有问题,但是显然问题太多了,有的甚至是我们从来都没想过的,在边回答边学习的过程中,我想起了自己刚开始摸索速卖通的时候,多希望能有个前辈能解答我的问题,于是我有了一个想法,我要写一些关于速卖通新手会遇到的问题这样一个新手快速入门手册,能让所有有心想要做

速卖通---发布商品aeopAeProductPropertys这个字段值报07004013的错误

由于文档的说明很少,导致里面改填写那些值都是靠自己推敲出来,当然可以根据他们的错误提示了研究,他们的错误提示也给出了相关的帮助了, 例如通过categoryid的200000001获取到"id":10,"values":[{"id":200002203,"names":{"zh":"醋酸纤维","en":"Acetate"},"attri

速卖通标题应如何选词,从而提高曝光。麦言站长【罗小迪】 直播

很荣幸邀请到麦言美女站长[罗小迪]进行直播分享~ 直播主题:速卖通标题应如何选词,从而提高曝光量. 直播时间:5月20日星期六晚8点  直播入口(两个途径,大家赶紧报名哈): 1.点击下面网址进入麦言直播入口: https://m.qlchat.com/live/850000023002978.htm 2.各位小伙伴也可以微信扫描下方二维码进入直播学堂报名: 不容错过,敬请期待~

第二篇:速卖通产品采集系列 之 产品采集实战

上一篇,对速卖通产品采集做了分析,包含要采集产品信息,以及如何采集这些产品信息,这一篇接着来采集实战,相关技术前篇也说过了,不废话直接开项目做. 一, 创建解决方案,编写采集代码 1. 创建解决方案“CollectorSolution”,在其中新建“Collector” 空 ASP.NET MVC 项目,解决方案结构图如下: 2.在“Collector” 项目中,分别新增“CollectingController” 控制器,以及和控制器相关的视图,并将原来默认路由 Home -> Index 改