[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”就代表這個商品入庫失敗。