[TOC] >## **接口文件返回数据基本说明** 接口文件接收数据并保存数据后，必须按照18助手的规范格式返回入库结果，否者18助手无法识别是否入库成功，导致反复提交入库数据的异常。 接口文件必须返回如下类似数据： ``` {"state":"ok","code":0,"message":"提示信息或者结果数据","version":"8.88","system":"淘客系统名字","updatetime":"2020年06月06日"} ``` (注意：返回数据的开头必须是字符串`{"state":"ok"`，并且不能包含空格。返回的数据必须是规范的json格式。) **接口返回json格式数据字段说明：** | 字段 | 示例值 | 说明 | | --- | --- | --- | | state | ok | 返回数据的开头必须是字符串`{"state":"ok"` (因为有时候因为网络不稳定，接口可能存在无法访问的情况，助手通过简单的字符串判断，就能知道接口文件是否能正常访问) | | code| 1 | 入库失败的时候请返回0，入库成功的时候请返回1 | | message| 验证成功 | message的返回值是根据具体执行的任务来定。**verify**(执行验证任务时，message返回的是提示消息，文字内容随意) ， **执行订单或商品入库任务时**(message返回由订单编号或者商品ID构造的特殊字符串，构造方法可参考下面的返回示例及说明) | | version| 8.88 | 接口文件版本号，非必须参数| | system| 18淘客系统 | 淘客系统名字，非必须参数| | updatetime| 2020年06月06日 | 淘客系统名字，非必须参数| <br> >## **接口文件—验证(verify)时返回数据示例** 验证成功时: ``` {"state":"ok","code":1,"message":"验证成功","updatetime":"2020年08月08日"} ``` 验证失败时: ``` {"state":"ok","code":0,"message":"密钥错误(或其他失败原因),"updatetime":"2020年08月08日"} ``` <br> >## **接口文件—淘客订单入库(postorder)时返回数据示例** ``` {"state":"ok","code":1,"message":"result:634871779380010354:1|634044320400010354:1|633160450048010354:1","version":"1.8","system":"淘宝客系统","updatetime":"2020年08月08日"} ``` message的值必须类似 `result:634871779380010354:1|634044320400010354:1` 格式，“634871779380010354” 为淘宝订单编号(对应post过来订单数据的"订单编号"字段),冒号后面的“1”代表这条订单入库成功，如果冒号后面是“0”就代表这个订单入库失败。  <br> >## **接口文件—京东订单入库(postjdorder)时返回数据示例** ``` {"state":"ok","code":1,"message":"result:161462808396:1|162499620928:1|161462808396:1","version":"1.8","system":"淘宝客系统","updatetime":"2020年08月08日"} ``` message的值必须类似 `result:161462808396:1|161462808396:1` 格式，“161462808396” 为京东订单编号(对应post过来订单数据的"orderId"字段),冒号后面的“1”代表这条订单入库成功，如果冒号后面是“0”就代表这个订单入库失败。 <br> >## **接口文件—拼多多订单入库(postpddorder)时返回数据示例** ``` {"state":"ok","code":1,"message":"result:210180-517997896552601:1|210180-517997896552602:1|210180-517997896552603:1","version":"1.8","system":"淘宝客系统","updatetime":"2020年08月08日"} ``` message的值必须类似 `result:210180-517997896552601:1|210180-517997896552602:1` 格式，“210180-517997896552601” 为拼多多订单编号(对应post过来订单数据的"订单编号"字段),冒号后面的“1”代表这条订单入库成功，如果冒号后面是“0”就代表这个订单入库失败。 <br> >## **接口文件—唯品会订单入库(postviporder)时返回数据示例** ``` {"state":"ok","code":1,"message":"result:23353a7e4ff08cee83695db6cedb7732:1|bafcf8cfe6d148db3f8203f682765960:1|bafcf8cfe6d148db3f8203f682765969:1","version":"1.8","system":"淘宝客系统","updatetime":"2020年08月08日"} ``` message的值必须类似 `result:23353a7e4ff08cee83695db6cedb7732:1|bafcf8cfe6d148db3f8203f682765960:1` 格式，“23353a7e4ff08cee83695db6cedb7732” 为唯品会订单的唯一ID，该ID是18助手根据算法所得(对应post过来订单数据的"orderKey"字段),冒号后面的“1”代表这条订单入库成功，如果冒号后面是“0”就代表这个订单入库失败。 <br> >## **接口文件—蘑菇街订单入库(postmgjorder)时返回数据示例** ``` {"state":"ok","code":1,"message":"result:89251996545310:1|89251996545311:1|89251996545312:1","version":"1.8","system":"淘宝客系统","updatetime":"2020年08月08日"} ``` message的值必须类似 `result:89251996545310:1|89251996545311:1` 格式，“89251996545310” 为蘑菇街子订单编号(对应post过来订单数据的"subOrderNo"字段),冒号后面的“1”代表这条订单入库成功，如果冒号后面是“0”就代表这个订单入库失败。 <br> >## **接口文件—苏宁订单入库(postsnorder)时返回数据示例** ``` {"state":"ok","code":1,"message":"result:c7122f628842956722d7e9c5e7df26ef:1|d78f3d2aec0b54896dcf9c18b3a9d1ee:1|14f852e251945b886f90885345a995ea:1","version":"1.8","system":"淘宝客系统","updatetime":"2020年08月08日"} ``` message的值必须类似 `result:c7122f628842956722d7e9c5e7df26ef:1|d78f3d2aec0b54896dcf9c18b3a9d1ee:1` 格式，“result:c7122f628842956722d7e9c5e7df26ef” 为苏宁订单的唯一ID，该ID是18助手根据算法所得(对应post过来订单数据的"orderKey"字段),冒号后面的“1”代表这条订单入库成功，如果冒号后面是“0”就代表这个订单入库失败。 <br> >## **接口文件—多麦订单入库(postdmorder)时返回数据示例** ``` {"state":"ok","code":1,"message":"result:235097228:1|235097229:1|235097230:1","version":"1.8","system":"淘宝客系统","updatetime":"2020年08月08日"} ``` message的值必须类似 `result:c7122f628842956722d7e9c5e7df26ef:1|d78f3d2aec0b54896dcf9c18b3a9d1ee:1` 格式，“result:c7122f628842956722d7e9c5e7df26ef” 为多麦订单的唯一ID(对应post过来订单数据的"id"字段),冒号后面的“1”代表这条订单入库成功，如果冒号后面是“0”就代表这个订单入库失败。 <br> >## **接口文件—淘宝商品入库(postgoods)时返回数据示例** ``` {"state":"ok","code":1,"message":"result:600517739920:1|600517739925:1|600517739926:1","version":"1.8","system":"淘宝客系统","updatetime":"2020年08月08日"} ``` message的值必须类似 `result:600517739920:1|600517739925:1` 格式，“600517739920” 为淘宝商品ID(对应post过来商品数据的"商品ID"字段),冒号后面的“1”代表这条商品入库成功，如果冒号后面是“0”就代表这个商品入库失败。