电脑
聚石塔服务器账号密码
首先我们打开淘宝开发平台,然后点击右上角的登录按钮。输入账号密码登录进去。
登录进去之后我们看到正上方有个“控制台”。点击进去。进来之后可以看到我们自己添加的应用。奇门的配置是在“云工作台”。点击打开“云工作台“。
在左边的菜单栏找到“业务系统构建&集成”。这个下面有个“奇门API网关”。点击打开。如果我们是第一次打开的话,里面是空的,这样子我们就需要点击“创建场景”。注意:奇门云网关有两种场景模式可以选择。第一种是“自定义服务“;第二种是“官方服务集成”;这两种的区别在于自定义里面的所有api都是我们自己去配置;官方集成服务的话是官方已经配置后的api,你只要配置上聚石塔的地址调用就可以了。官方集成服务的缺点在于接口少,只有所有api接口的十分之三左右全都是订单方面的api。自定义的话就是你想要什么接口自己配置就行了。
“创建场景”里面带星号的必填。场景名称就是你这个api是用于那块的业务。类型自己感觉自己的实际情况去选择。描述也是感觉自己的实际情况填写。添加完成后会有一个你添加的场景出现在列表。然后点击场景的“管理”。去配置API接口。
到这里就是我们今天要说的重中之重。奇门具体api的信息配置。我们用自定义服务来说说怎么配置。首先我们点击我们创建的场景后面的“管理”进去。第一次进来里面是没有任何api的。任何我们点击左上角的“创建API”按钮。
在api的创建的页面,首先我们看到整个创建的流程。请求配置-》响应配置-》接口文档预览-》自测环境-》正式发布。
我先来配置api的请求配置,请求配置需要配置的信息有:基本信息,请求参数,请求映射。1、基本信息。api的接口名称的规则是:自己应用的英文名称.业务.操作。差不多是这样子。例如:test.aliexpress.postproductsizemodelsrequiredfor。然后就是API的中文名称,如:判断叶子类目是否必须尺码表。其次就是API的功能描述:如:判断叶子类目是否必须尺码表。2、请求参数。里面有两个设置项,Query Parameters和Body。Query Parameters这个不用可以不管。重要的是Body。Body是你要发送过去请求的参数。如,查询的类目id,或是查询的店铺ID等。报文类型选自己需要的类型就行,如josn或是XML。Body设置的参数要选择参数的类型,参数说明,和设置是否必填。参数可以添加多个。3、请求映射。这个主要的就是映射你的聚石塔请求的地址。服务后端正式URL,服务后端测试URL。这两个地址其实都写你聚石塔这个借口的请求地址就可以了。然后超时设置(毫秒)这个记得要设置大点,因为是毫秒,设置太小会容易提示超时。这里设置好后点击“下一步”去设置
响应设置。这里就是配置你请求聚石塔的时候,数据的返回格式。也就是响应参数。这要吧这里设置后就行了。这里不用设置其他东西。报文类型要和你前面设置的一致。设置好后点击“下一步”。
接口文档预览。这里的话就没有什么可以设置的了,这里就是要你看下自己配置的接口参数和结构。如果感觉没问题,就点击“进入到自测环境”,如果感觉那里设置的有问题,就点击“上一步”再去确认和修改。这里我们往下走。点击“进入到自测环境”。
进到自测环境。选在我们设置的返回格式,运行的环境,测试或是设置。还有我们这个接口的请求参数。设置好后点击“提交测试”。看下返回的数据是不是我们接口设置的数据。如果返回的数据结构和我们配置的响应结构一样没有问题,那就证明配置OK完全没有问题。直接点击“自测通过请发起服务验证”。这个验证就是验签。下载sdk的时候有那个验签的方法,就是去验证你的请求的时候秘钥什么的对不对,有没有什么问题,这个验签他会给你发送一个错误的信息,如果验签设置没有问题了,会验证成功,否则会失败。验证成功,点击“提交审核”。然后等平台审核,通过了之后,然后再去点击“发布“。这样子API就发布成功了。
奇门的设置验证不会设置的可以在咨询我。这个确实第一次设置的时候很麻烦。以上有什么说的不对的地方,可以留言交流。