2016-09-06 51 views
1

我是新來的swagger文檔。我們有一個爲RESTFul Web服務開發的現有項目。不同的基於資源的網址以application/json格式消費和生成。我們的資源URL的一個輸入和輸出JSON格式下面給出:如何將我的自定義json轉換爲swagger 2.0 json

請求:

{ 
    "request": { 
     "companyNumber": 5000, 
     "operatorInit": "sys", 
     "operatorPassword": "", 
     "customerNumber": 101, 
     "shipTo": "", 
     "warehouse": "01", 
     "productCode": "2-001", 
     "crossReferenceFlag": false, 
     "retrieveFlag": false, 
     "tInbinlocation": { 
     "t-inbinlocation": [ 
      { 
      "binloc": "", 
      "icswbinloc1fl": false, 
      "icswbinloc2fl": false, 
      "addrecordfl": false, 
      "deleterecordfl": false, 
      "charuser": "", 
      "user1": "", 
      "user2": "", 
      "user3": "", 
      "user4": "", 
      "user5": "", 
      "user6": 0, 
      "user7": 0, 
      "user8": null, 
      "user9": null 
      } 
     ] 
     }, 
     "tInfieldvalue": { 
     "t-infieldvalue": [ 
      { 
      "level": "", 
      "lineno": 0, 
      "seqno": 0, 
      "fieldname": "", 
      "fieldvalue": "" 
      } 
     ] 
     } 
    } 
} 

響應:

{ 
    "response": { 
    "cErrorMessage": "", 
    "crossReferenceProduct": "2-001", 
    "crossReferenceType": "", 
    "tOutbinlocation": { 
     "t-outbinlocation": [] 
    }, 
    "tOutfieldvalue": { 
     "t-outfieldvalue": [] 
    } 
    } 
} 

如何轉換上述請求和響應JSON格式轉換成招搖2.0 json格式?

謝謝!

回答

1

嘗試使用api-spec-converter
此工具支持在常用格式之間轉換API描述。

Supported formats: 
    * swagger_1 
    * swagger_2 
    * api_blueprint 
    * io_docs 
    * google 
    * raml 
    * wadl 
+0

我已經安裝了api-spec-converter。我正在嘗試調用api-spec-converter http:// /sxapi/rest/sxapirestservice/sxapiicbinlocationmnt --from = api_blueprint --to = swagger_2 swagger.json。但它給方法不支持錯誤。我們只支持POST請求。如何使用api-spec-converter做到這一點? –

+1

它不會根據用戶的請求將JSON轉換爲Swagger。 – OmegaMan

相關問題