Eu sou novo na documentação arrogante. Temos um projeto existente desenvolvido em linguagem de andamento para os Serviços Web RESTFul. Os diferentes URLs baseados em recursos consomem e produzem no formato application / json. Os formatos json de entrada e saída para um dos nossos URLs de recursos são apresentados abaixo:

{
"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": ""
}
]
}
}
}

Resposta:

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

Como converter os formatos json de solicitação e resposta acima no formato jagger swagger 2.0?

Obrigado!

Respostas:

Tente usar api-spec-converter.
essa ferramenta oferece suporte à conversão de descrições de API entre formatos populares.

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