关于创建奇门自定义api接口流程备忘录

项目需要对接速卖通的api，并使数据安全出聚石塔，采用的方法是在奇门创建自定义api进行消息的转发，为什么不走官方场景呢，我没试过，我同事说官方场景的api少字段，不满足需求，走自定义可以返回所有的字段数据。

但是走自定义api接口有一个问题，你需要创建所有的api的请求体和返回体，有些接口几百个字段，结构是一层套一层，你需要理清楚，并且和速卖通api接口的数据结构一致才能通过奇门的数据转发。

下面是速卖通的api文档地址，请记住，请求速卖通的api的包一定是

com.taobao.api...

这个包下的，不要导错包

开放平台-文档中心

创建api，api接口名称填写注意长度为50，超长会被 截取，一旦保存后不能修改，建议以你的公司英文开头或者项目名称开头，后面的和速卖通的保持一致，这样比较清晰的知道你开发的接口

请求参数，这个是请求链接后面拼接的参数，我是懒省事。直接在这里写了，但是数据类型只有这三个，简单的请求参数可以在这写，对照速卖通的api文档进行复制吧，注意空格，有空格保存不了的，需要一个示列， 填好方便后面测试

这里你可以添加一个id字段，这个是卖家登录id，如果你有多个店铺或者账号的话，代码是可以通用的，我们有一张表，存储着店铺的session信息，根据卖家登录id获取不同的session来请求数据

body里也可以设置请求的参数，这里适合使用复杂的请求体，有些接口需要嵌套数据结构，可以使用这个，下面的测试url可以写你本地开发的项目地址，正式的写聚石塔的项目部署地址，这个后期可以修改

返回请求参数数据结构体设计，这里是个重点，但凡你请求速卖通返回的数据结构，和你设计的数据结构有一点不一样，就不能通过奇门的数据转发，所以你不仅要参考速卖通api文档上的响应参数，还要参考下面的响应示例，应为实际返回的数据结构和api文档上结构有部分不一致

 
看标红的地方，首先最外面的这个结构响应参数上是没有的，

期次如果你碰见数组型的返回结构体，它里面会多一层结构体，比如下面的error_details，多了一层error_detail，所以你要么在代码中进行处理，要么在设计结构的时候把这一层加上

 注意事项，如果你碰见了返回的字段是number[]，或者是String[]，建议直接string把,因为很有可能返回的结构体是下面的这样的

{
 "text":{
       "number":[1,2,3]    
 }
}